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内 容 提 要 


本 书 介绍 如 何 将 各 种 TDD 最 佳 实践 应 用 于 Java 开发 ， 主 要 内 容 包 括 : 用 Java 语言 i 








的 各 种 工具 和 框架 ， 所 需 环境 搭建 ; 通过 实际 应 用 程序 ， 展 示 TDD 优点 及 开发 中 应 注意 的 主要 问题 ; 

















是 如 何 通过 模拟 内 部 和 外 部 依赖 来 提升 速度 的 ; 如 何 重 构 既 有 应 用 程序 ; 详细 介绍 所 有 TDD 最 人 






































本 书 适合 所 有 Java 开发 人 员 ， 也 适合 用 其 他 语言 编程 的 程序 员 了 解 TDD。 
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了 路 


前 


测试 驱动 开发 面世 已 有 一 段 时 间 , 但 依然 未 被 很 多 人 采用 ,因为 它 难以 掌握 。 虽 然 理论 很 容 
易 ， 但 要 熟练 使 用 ， 必 须 经 过 大 量 实践 。 


多 年 来 , 本 书 作者 一 直 在 使 用 TDD,， 并 试图 将 其 经 验 传授 给 你 。 身 为 开发 人 员 ,， 他们 深信 学 
习 编 码 实践 的 最 佳 方式 是 编写 代码 和 不 断 练习 , 本 书 秉承 的 正 是 这 种 理念 一 一 通过 练习 诠释 所 有 
TDD 概 念 。 本 书 犹 如 一 次 旅行 ， 期间， 你 有 机 会 将 各 种 TDD 最 佳 实践 应 用 于 Java 开 发 。 这 次 旅行 
结束 时 ， 你 将 成 为 TDD 黑 带 ， 你 的 软件 开发 工具 中 也 会 多 一 个 法 宝 。 









































本 书 内 容 


第 1 章 阐 述 我 们 的 目标 一 一 成 为 拥有 TDD 黑 带 的 Java 开 发 人 员 。 要 想 知 道 我 们 将 去 往 何 方 ， 
必须 对 一 些 描述 旅程 的 问题 进行 讨论 ， 并 找到 答案 。 


第 2 章 介绍 并 安装 本 书 将 用 到 的 所 有 工具 和 框架 , 再 搭建 所 需 的 环境 。 对 于 每 个 工具 和 框架 ， 
都 将 通过 代码 说 明 其 优 缺 点 。 


第 3 章 演示 如 何 使 用 TDD 的 支柱 “ 红 灯 - 绿 灯 -- 重 构 ” 过 程 开发 一 个 “ 井 字 游戏 ”。 我们 将 
编写 测试 并 确定 其 失败 ; 然后 编写 实现 测试 的 代码 ,运行 所 有 测试 并 确定 其 通过 ; 最 后 , 重 构 并 
完善 代码 。 


第 4 章 开 发 “遥控 军舰 ”应 用 程序 ， 以 充分 展示 TDD 在 单元 测试 中 的 威力 。 你 将 学 习 单 元 测 
试 到 底 是 什么 、 它 与 功能 测试 和 集成 测试 有 何不 同 以 及 它 在 测试 驱动 开发 中 扮演 的 角色 。 


第 5 章 以 传统 方法 开发 Connect4 游 戏 。 这 个 开发 过 程 中 ,没有 编写 任何 测试 ， 而 等 到 开发 结 
束 后 才 编 写 。 通 过 这 样 做 ， 你 将 认识 到 开发 应 用 程序 时 ， 如 果 不 采用 使 其 易于 测试 的 开发 方法 ， 
将 面临 什么 样 的 难题 。 

第 6 章 阐 述 速 度 对 TDD 来 说 至 关 重要 。 为 快速 演示 一 些 理念 和 概念 ， 我 们 将 扩展 前 面 开发 的 
“ 井 字 游戏 " ， 并 使 用 MongoDB 存 储 数据 。 所 有 测试 实际 上 都 没有 使 用 MongoDB ， 因 为 我 们 将 模 
拟 所 有 与 MongoDB 的 通信 。 








































































































图 灵 社 区 会 员 yasenluobinh(yasenluobinhappy@163.com) 专 享 尊重 版 权 








第 7 童 讨论 如 何 使 用 BDD 方 法 开发 一 个 书店 应 用 程序 。 我 们 将 以 BDD 方 式 制定 验收 标准 ,分 
别 实现 各 项 功能 。 通过 运行 BDD 场 景 确认 每 项 功能 都 能 正常 工作 , 并 在 必要 时 重 构 代码 使 其 达到 
预期 的 质量 水 平 。 

第 8 章 介绍 如 何 重 构 既 有 的 应 用 程序 。 我 们 将 首先 为 既 有 代码 创建 测试 ， 然 后 不 断 重 构 ， 直 
到 测试 和 代码 都 满足 预期 。 

第 9 章 演 示 如 何 开发 一 个 斐 波 那 契 数列 计算 器 ， 以 及 如 何 使 用 功能 开关 隐藏 还 未 完成 或 出 于 
商业 考虑 不 应 向 用 户 发 布 的 功能 。 

第 10 章 详细 介绍 所 有 TDD 最 佳 实践 ， 并 温习 通过 阅读 本 书 获得 的 知识 和 经 验 。 























需要 什么 


为 完成 本 书 的 练习 , 读者 必须 有 一 台 64 位 计算 机 。 对 于 各 种 需要 用 到 的 软件 ， 本 书 提供 了 详 
尽 的 安装 说 明 。 








为 谁 而 写 
如 果 你 是 经 验 丰富 的 开发 人 员 , 想 学 习 更 有 效 的 系统 和 应 用 程序 开发 方法 , 那么 本 书 就 是 为 
你 而 写 的 。 


排版 约定 
为 将 不 同类 型 的 信息 区 分 开 来 ， 本 书 使 用 了 很 多 文本 样式 。 下 面 列 出 其 中 一 些 样 式 及 含义 。 


正文 中 的 代码 、 数 据 库 表 名 、 文 件 夹 名 称 、 文 件 名 、 文 件 扩展 名 、 路 径 名 、URL 、 用 户 输入 
和 Twitter 账号 ， 使 用 如 下 样式 : 

“通过 使 用 指令 include， 可 包含 其 他 上 下 文 。” 

代码 块 使 用 如 下 样式 : 

public class Friendships { 


private final Map<String, List<String>> friendships = new 
HashMap<>(); 














public void makeFriends (String personl, String person2) { 
addFriend (personl, person2); 
addFriend (person2, personl]l); 
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>) 
pc 


| 
(We 





命令 行 输入 或 输出 使 用 如 下 样式 : 


$> vagrant plugin install vagrant-cachier 
$> git clone thttps://bitbucket.org/vfarcic/tdd-java-ch02-example- 
vagrant .git 


新 术语 和 重要 词语 使 用 粗 体 。 例如, 对 于 出 现在 屏幕 上 的 菜单 或 对 话 框 中 的 词语 ， 





“输入 查询 后 ， 将 看 到 按钮 Go， 请 单 击 。” 








| 心 、 警告 或 重要 的 注意 事项 。 


RY 
| 提示 和 技巧 。 


读者 反馈 














表示 如 下 : 


欢迎 提供 反馈 ， 请 将 你 对 本 书 的 看 法 告诉 我 们 : 哪些 方面 是 你 喜欢 的 ， 哪 些 方面 你 不 喜欢 。 


读者 反馈 对 我 们 来 说 很 重要 ， 因 为 这 可 以 帮助 我 们 推出 更 符合 读者 需求 的 著作 。 











要 给 我 们 提供 反馈 ,只 需 向 feedback@packtpub.com 发 送 电 子 邮 件 , 并 在 邮件 主题 中 指出 书 名 。 
如 果 你 有 擅长 的 主题 ,并 有 志 于 写 书 或 拟稿 ， 请 参阅 www.packtpub.com/authors 的 撰 稿 指南 。 























客户 支持 
购买 本 社 图 书后 ， 你 将 获得 各 种 帮助 ， 让 手中 图 书 最 大 限度 地 发 挥 功 效 。 





勘误 





虽然 我 们 力图 让 图 书 内 容 准 确 无 误 , 但 错误 仍 不 可 避免 。 如 果 你 在 本 社 图 书 中 发 现 错误 ( 包 








or 


还 可 帮助 我 们 改进 该 书 的 后 续 版 本 。 无 论 你 发 现 什么 错误 ， 都 请 告诉 我 们 。 为 此 ， 
http:/www.packtpub.com/submit-errata， 输 入 书 名 ， 单 击 链接 Errata Submission Form ， 
误 详 情 。 提 交 的 勘误 得 到 确认 后 ， 将 被 上 传 到 我 们 的 网 站 或 添加 到 既 有 的 勘误 列表 。 




















血 正文 和 代码 ), 请 告诉 我 们 , 我 们 将 感激 不 尽 。 你 这 样 做 不 仅 可 以 让 其 他 读者 免 遭 同样 的 挫折 ， 


可 以 访问 
再 输入 错 




















要 查看 已 提交 的 勘误 , 请 访问 https://www.packtpub.com/books/content/support， 并 在 搜索 框 中 





输入 书 名 ，Errata 栏 将 列 出 你 搜索 的 信息 。 
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打击 盗版 


网 上 散布 的 盗版 材料 是 各 类 媒体 展 禁 不 绝 的 问题 。 在 保护 版 权 和 许可 方面 , 本 社 的 态度 非 党 
严肃 。 如 果 你 在 网 上 看 到 本 社 作品 的 非法 复制 品 , 请 马上 把 网 址 或 网 站 名 告诉 我 们 ， 以 便 我 们 能 
够 采取 补救 措施 。 


请 通过 copyright@packtpub.com 与 我 们 取得 联系 ， 并 提供 可 疑 的 盗版 材料 链接 。 


感谢 你 为 保护 我 们 的 作者 提供 的 帮助 ， 也 十 分 感激 对 于 我 们 提供 有 价值 内 容 的 能 力 给 予 的 
保护 。 


























问题 


只 要 有 与 本 书 相关 的 问题 ,都 可 通过 questions@packtpub.com 与 我 们 联系 ,我 们 将 尽力 解决 。 





电子 书 
扫描 如 下 二 维 码 ， 即 可 购买 本 书 电子 版 。 
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为 何 要 关心 测试 驱动 开发 






































本 书 的 作者 是 开发 人 员 , 针对 的 读者 也 是 开发 人 员 ， 因 此 大 部 分 学 习 都 将 通过 代码 进行 。 
章 都 将 介绍 一 个 或 多 个 TDD 实 践 ， 读 者 将 通过 完成 套路 掌握 它们 。 在 空手 道中 ， 套 路 ( kata ) 是 
一 种 练习 ， 学 习 者 不 断 重 复 同 样 的 招式 ， 每 次 重复 都 进步 一 点 点 。 同 样 ， 读 者 阅读 每 章 后 ， 都 将 
有 细微 但 意义 重大 的 进步 。 你 将 学 习 如 何 改善 设计 和 代码 、 缩 短 上 市 时 间 、 提 供与 时 俱 进 的 文档 、 
通过 质量 测试 提高 代码 覆盖 率 以 及 编写 行 之 有 效 的 清晰 代码 。 


旅程 都 有 起 点 , 本 书 也 不 例外 。 我 们 的 目标 是 让 你 成 为 拥有 测试 驱动 开发 (TDD ) 黑 带 的 Java 
开发 人 员 。 

为 确定 我 们 将 走向 何方 , 必须 就 一 些 决定 航程 的 问题 进行 讨论 并 找到 答案 。 何 为 TDD? 这 是 
一 种 测试 方法 还 是 别 的 什么 东西 ? 使 用 TDD 有 何 好 处 ? 







































































本 章 提 在 提供 针对 TDD 的 整体 概括 ， 帮 你 了 解 TDD 定 义 及 其 优势 。 
本 章 涵 盖 如 下 主题 : 


口 理解 TDD ; 

口 何 为 TDD ; 

口 测试 ; 

口 模拟 ; 

口 可 执行 的 文档 ; 
口 无 需 调 试 。 





1.1 为 何 要 使 用 TDD 


你 所 处 的 环境 使 用 的 可 能 是 敏捷 开发 方法 , 也 可 能 是 瀑布 开发 方法 ; 你 们 公司 可 能 有 明确 的 
规程 ， 这 些 规程 经 过 了 多 年 艰 若 奋斗 的 洗礼 ; 也 可 能 ,你们 只 是 一 家 刚刚 起 步 的 创业 公司 。 无 论 
如 何 ， 你 都 很 可 能 面临 过 下 述 一 个 乃至 更 多 痛 点 、 问 题 或 导致 交付 失败 的 原因 : 
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口 部 分 团队 成 员 无 缘 参 与 需求 、 规 范 或 用 户 故 事 的 制定 ; 

口 大 部 分 乃至 全 部 测试 都 是 手动 的 ， 抑 或 根本 就 没有 测试 ; 

口 虽然 使 用 了 自动 化 测试 ， 但 并 未 检测 出 真正 的 问题 ; 

口 编写 并 执行 自动 化 测试 的 时 间 太 晚 ， 无 法 给 项 目 带 来 真正 的 价值 ; 
口 总 是 有 更 紧急 的 问题 需要 处 理 ， 没 法 腾 出 专门 用 于 测试 的 时 间 ; 
口 整个 团队 分 为 测试 、 开 发 和 功能 分 析 小 组 ， 而 这 些小 组 常常 不 能 同步 ; 
口 无 法 重 构 代 码 ， 因 为 担心 这 样 做 会 破坏 既 有 的 功能 ; 

口 维护 成 本 高 ; 

口 上 市 时 间 过 长 ; 

口 客户 觉得 交付 的 产品 不 符合 要 求 ; 

口 文档 从 来 都 不 是 最 新 的 ; 

口 害怕 部 署 到 生产 环境 ， 因 为 结果 无 法 预料 ; 

口 常常 无 法 部 署 到 生产 环境 ， 因 为 运行 回归 测试 的 时 间 太 长 ; 

口 团队 为 搞 清楚 某 些 方法 或 类 的 作用 花费 的 时 间 太 多 。 


测试 驱动 开发 并 不 能 神奇 地 解决 所 有 这 些 问题 , 而 只 为 我 们 找到 解决 方案 指明 方向 。 世上 没 
有 灵丹妙药 ,但 如 果 有 什么 开发 实践 能 让 众多 层面 的 情况 大 不 相同 ， 那 就 是 TDD。 


测试 驱动 开发 可 缩短 上 市 时 间 、 简 化 重 构 工作 、 帮 助 创建 更 好 的 设计 以 及 降低 看 合 程度 。 


除 这 些 直 接 的 好 处 外 ,TDD 还 是 众多 其 他 实践 ( 如 持续 交付 ) 的 前 提 条 件 。 使 用 TDD 可 改善 
设计 和 代码 的 质量 、 缩 短 上 市 时 间 、 确 保 文 档 最 新 、 获 得 极 高 的 代码 覆盖 率 等 。 


要 掌握 TDD 并 不 那么 容易 。 即 便 学 习 了 所 有 的 理论 ， 仔 细 研 究 了 最 佳 实践 和 反 模 式 ， 旅 程 
也 才刚 刚 开 始 。 要 掌握 TDD 需 要 很 长 的 时 间 和 大 量 的 实践 ， 这 是 瘟 长 的 过 程 ， 绝 不 是 阅读 完 本 
书 就 能 结束 的 。 事 实 上 ， 这 个 过 程 根本 就 没有 结束 的 时 候 ， 因 为 总 是 有 新 的 方式 面世 ， 让 你 能 
够 更 熟练 、 更 快捷 地 使 用 TDD。 然而 , 需要 付出 的 代价 虽然 很 高 , 但 带 来 的 好 处 更 多 。 使 用 TDD 
的 时 间 足 够 长 的 人 都 宣称 没有 其 他 开发 软件 的 方法 ， 我 们 就 是 这 样 的 人 ， 你 肯定 也 会 成 为 其 中 


已 
一 由。 


学 习 编 码 技巧 的 最 佳 方式 是 实践 , 我们 对 此 深信 不 疑 。 要 掌握 本 书 介绍 的 内 容 , 仅 在 上 班 的 
路 上 翻阅 还 不 够 ;这 不 是 一 本 适合 躺 在 床上 阅读 的 书 ， 你 必须 的 起 袖子 动手 编写 代码 。 


本 章 将 介绍 基础 知识 , 但 从 下 一 章 开始 ,你 将 通过 阅读 、 编 写 和 运行 代码 进行 学 习 。 我 很 想 
说 等 阅读 完 本 书后 ,你 就 是 经 验 丰 富 的 TDD 程 序 员 了 , 但 情况 不 是 这 样 的 。 读 完 本 书 , 你 将 熟悉 
TDD, 并 拥有 坚实 的 理论 和 实践 基础 ， 而 剩 下 的 事 就 全 靠 你 自己 了 。 要 想 获得 更 多 TDD 经 验 , 你 
必须 在 日 常 工作 中 使 用 TDD。 
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1.1 为 何 要 使 用 TDD 3 


1.1.1 理解 TDD | 


此 时 你 可 能 正 自 言 自 语 :“ 我 知道 TDD 会 带 来 一 些 好 处 ,但 测试 驱动 开发 到 底 是 什么 呢 ?” 
TDD 是 一 种 简单 的 流程 ,要求 你 先 编写 测试 , 再 编写 实现 代码 ,这 与 “编写 代码 后 再 测试 ”的 传 
统 方 法 相反 。 




























































































1.1.2” 红 灯 - 绿 灯 - 重 构 


测试 驱动 开发 是 一 个 过 程 ， 依 赖 于 不 断 重复 极 短 的 开发 周期 。 它 基于 极限 编程 (XP ) 的 测 
试 优先 理念 , 倡导 采用 可 高 度 信赖 的 简单 设计 。 驱 动 这 个 流程 前 行 的 开发 周期 称 为 “ 红 灯 - 绿 灯 - 
重 构 ”。 


这 种 流程 本 身 很 简单 ， 由 儿 个 反复 进行 的 步骤 组 成 : 


(1) 编写 一 个 测试 ; 
(2) 运行 所 有 测试 ; 
(3) 编写 实现 代码 ; 
(4) 运行 所 有 测试 ; 
(5) 重 构 ; 
(6) 运行 所 有 测试 。 
鉴于 测试 是 在 实现 前 编写 的 ， 因 此 它 应 该 不 能 通过 。 如 果 通 过 了 ， 就 说 明 测 试 是 错误 的 : 要 
么 它 描述 的 功能 早已 存在 , 要么 编写 不 正确 ,编写 测试 期 间 处 于 绿灯 状态 昭示 着 存在 错 报 的 问题 ， 
对 于 这 样 的 测试 ， 应 将 其 删除 或 进行 重 构 。 








































































































编写 测试 时 , 应 处 于 红 灯 状 态 。 完 成 测试 要 求 的 实现 后 , 所 有 测试 都 应 通过 ， 
~ 此 时 将 处 于 绿灯 状态 。 





如 果 最 后 一 个 测试 未 通过 ,就 说 明 实现 不 正确 ,必须 修 正 : 要 人 么 这 个 测试 不 正确 , 要 人 么 实现 
代码 不 符合 我 们 制定 的 规范 。 如 果 其 他 测试 未 通过 ,就 说 明 我 们 破坏 了 某 种 功能 ,必须 撤销 所 做 
的 修改 。 


在 这 种 情况 下 , 一 种 自然 而 然 的 反应 是 : 花 足 够 的 时 间 修 复 代 码 , 让 所 有 测试 都 通过 。 然而 ， 
这 样 的 做 法 是 错误 的 。 如 果 不 能 在 儿 分 钟 内 完成 修复 , 最 佳 的 选择 是 撤销 所 做 的 修改 。 毕 竞 修改 
前 一 切 都 正常 ， 带 来 破坏 的 实现 显然 是 错误 的 。 为 何不 到 原来 的 地 方 , 重新 考虑 实现 测试 的 正确 
方式 呢 ? 这 样 我 们 只 是 在 错误 的 实现 上 浪费 了 几 分钟 , 而 不 会 为 修复 一 开始 就 不 正确 的 东西 浪费 
更 多 时 间 。 原 有 的 测试 覆盖 率 ( 不 包括 最 后 一 个 测试 的 实现 ) 应 该 很 高 。 我 们 通过 有 意识 地 重 构 
来 修改 既 有 代码 ， 而 不 将 其 作为 修复 最 近 编写 的 代码 的 方式 。 
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不 要 试图 让 最 后 一 个 测试 的 实现 完美 无 缺 ,而 应 只 编写 足以 让 这 个 测试 通过 
的 代码 。 
你 可 以 任何 喜欢 的 方式 编写 代码 , 但 要 快 。 一 旦 进入 绿灯 状态 ,我 们 就 知道 存在 一 个 由 测试 





构成 的 安全 网 ， 可 接着 重 构 代 码 了 : 改进 和 优化 代码 , 但 不 引入 新 功能 。 重 构 结 束 后 ， 所 有 测试 
应 当 在 任何 情况 下 都 能 通过 。 


如 果 重 构 期 间 有 测试 未 通过 ， 就 说 明 重 构 破坏 了 既 有 功能 ， 应 像 以 前 一 样 撤销 所 做 的 修改 。 
在 重 构 阶段 ， 我 们 不 修改 任何 功能 ， 也 不 引入 新 的 测试 ， 而 只 改进 代码 ， 并 不 断 运行 所 有 测试 ， 
确保 没有 破坏 任何 功能 。 与 此 同时 ， 我 们 证 明了 代码 是 正确 的 ， 并 降低 了 未 来 的 维护 成 本 。 


重 构 结 束 后 ， 再 重复 整个 过 程 。 这 是 一 个 无 限 循环 ， 每 次 循环 都 是 一 个 极 短 的 周期 。 












































1.1.3 ”速度 是 关键 


想 想 打 乒 兵 球 的 情形 吧 。 这 项 运动 的 节奏 非常 决 ， 职 业 选 手 玩 起 来 可 能 让 人 目不暇接 ,TDD 
与 这 项 运动 很 像 。TDD 老 手 通 常 不 会 让 接 球 ( 编写 测试 或 实现 的 ) 时 间 超 过 一 分 钟 : 编写 简短 的 
测试 并 运行 所 有 测试 《 乒 )， 编 写实 现 并 运行 所 有 测试 ( 乓 )， 青 编写 一 个 测试 ( 乒 )， 编 写 该 测 
试 的 实现 ( 乓 ), 重 构 并 确认 所 有 测试 都 通过 ( 计 分 ); 然后 重复 上 述 过 程 : 兵 、 乓 、 兵 、 乓 、 计 
分 。 不 要 试图 让 代码 完美 无 缺 ， 而 应 力图 让 球 不 断 运 动 ， 直 到 需要 计 分 ( 重 构 ) 为 止 。 















































< 
| ea 测试 和 实现 的 切换 时 间 应 以 分 钟 甚至 秒 计 。 | 
1.1.4 TDD 并 非 测试 方法 

















TDD 中 的 T 常 常 遭 人 误解 。 测 试 驱动 开发 是 一 种 设计 方法 ， 要 求 在 编写 代码 前 考虑 实现 以 及 
代码 需要 提供 的 功能 , 且 每 次 只 关注 一 项 功能 的 需求 和 实现 一 一 这 有 助 于 理 清 四 路 以 及 更 好 地 组 
织 代码 。 这 并 不 意味 着 使 用 TDD 时 编写 的 测试 毫 无 用 处 ,甚至 恰好 相反 : 它们 很 有 用 ,让 我 们 能 
够 以 极 快 的 速度 进行 开发 ， 同 时 不 担心 破坏 既 有 功能 。 对 重 构 来 说 这 显得 尤为 重要 : 能 够 在 不 担 
心 破坏 既 有 功能 的 情况 下 重新 组 织 代码 对 改善 质量 大 有 神 益 。 





















































| 总 测试 驱动 开发 的 主要 目标 是 提供 可 测试 的 代码 设计 ,测试 只 是 一 项 很 有 用 的 | 
副产品 。 
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1.2 测试 
虽然 测试 驱动 开发 主要 是 一 种 代码 设计 方法 , 但 测试 也 是 其 中 一 个 很 重要 的 方面 ,因此 我 们 
必须 对 如 下 两 种 测试 方法 有 清晰 的 认识 : 


口 黑 盒 测试 ; 
口 白 盒 测试 。 




















1.2.1 黑 盒 测试 


黑 盒 测 试 ( 也 叫 功 能 测试 ) 将 受 测 软 件 视 为 一 个 黑 盒 ， 无需 知道 其 内 部 构造 。 这 种 测试 是 通 
过 软件 界面 进行 的 ， 旨 在 确认 它们 像 预期 的 那样 工作 。 只 要 界面 的 功能 未 变 , 测试 就 应 通过 一 一 
即便 内 部 构造 发 生 了 变化 。 测 试 人 员 知 道 程序 该 做 什么 ,但 不 知道 它 是 如 何 做 的 。 黑 盒 测 试 是 传 
统 组 织 最 常 使 用 的 测试 类 型 。 这 种 组 织 通常 将 测试 人 员 划 归 到 一 个 独立 的 部 门 一 一 在 测试 人 员 不 
熟悉 编程 、 难 以 理解 代码 时 尤其 如 此 。 这 种 测试 方法 提供 了 外 部 观察 受 测 软件 的 结果 。 


下 面 是 黑 盒 测试 的 一 些 优 点 : 

口 可 高 效 测试 大 块 代码 段 ; 

口 无 需 访问 和 理解 代码 ， 也 不 要 求 测试 人 员 知 道 如 何 编写 代码 ; 
口 将 用 户 角 度 和 开发 人 员 角 度 分 离 。 

下 面 是 黑 盒 测试 的 一 些 缺 点 : 

口 覆盖 率 有 限 ， 因 为 只 执行 部 分 测试 场景 ; 

口 测试 效率 低下 ， 因 为 测试 人 员 对 软件 内 部 构造 一 无 所 知 ; 

口 测试 缺乏 针对 性 ， 因 为 测试 人 员 对 应 用 程序 的 了 解 有 限 。 


用 于 驱动 开发 的 测试 通常 是 根据 验收 标准 进行 的 ， 而 验收 标准 决定 了 要 开发 哪些 功能 。 



































































































































AL 
| QQ 自动 化 黑金 测试 依赖 于 某 种 形式 的 自动 化 ， 如 行为 驱动 开发 BDD )。 ] 


1.2.2 ”和 白 盒 测试 


盒 测试 (也 叫 透明 盒 测试 、 玻 璃 盒 测 试 和 结构 测试 ) 查看 受 测 软件 的 内 部 ,并 将 由 此 获得 

的 知识 用 于 测试 过 程 。 例 如 ， 如 果 在 特定 条 件 下 应 引发 异常 ， 可 能 需要 在 测试 中 重 现 这 种 条 件 。 

盒 测试 要 求 测试 人 员 了 解 系统 的 内 部 结构 ,同时 具备 编程 技能 ; 它 提 供 了 从 内 部 观察 受 测 软件 
的 结果 。 
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下 面 是 白 盒 测试 的 一 些 优点 : 


口 可 高 效 找 出 错误 和 问题 ; 

口 知道 受 测 软件 的 内 部 构造 有 助 于 进行 详细 测试 ; 

口 能 够 发 现 隐藏 的 错误 ; 

口 可 帮助 程序 员 反 省 ; 

口 有 助 于 优化 代码 ; 

口 由 于 知道 软件 的 内 部 构造 ， 因 此 可 最 大 限度 地 提高 测试 覆盖 率 。 
下 面 是 白 盒 测试 的 一 些 缺 点 : 

口 可 能 无 法 发 现 未 实现 或 缺失 的 功能 ; 

口 需要 对 受 测 软件 的 内 部 构造 有 大 致 认识 ; 

口 需要 访问 代码 ; 

口 测试 通常 与 产品 代码 的 实现 细节 紧密 耦合 ， 导 致 重 构 代 码 后 原本 应 该 通过 的 测试 未 能 


盒 测试 几乎 都 是 自动 化 测试 ， 且 在 大 多 数 情况 下 都 是 单元 测试 。 







































































< 
| QN 在 实现 前 执行 的 白金 测试 是 以 TDD 方 式 编写 的 。 ] 


1.2.3 ”质量 检查 和 质量 保证 的 差别 


还 可 根据 要 达成 的 目标 对 测试 方法 进行 分 类 。 要 达成 的 目标 通常 有 两 种 : 质量 检查 〈QC) 
和 质量 保证 〈《QA) 。 质 量 检查 的 重点 是 发 现 缺陷 ， 而 质量 保证 力图 将 缺陷 消灭 在 萌芽 状态 。QC 
是 面向 产品 的 ， 旨 在 确保 结果 符合 预期 ， 而 QA 更 专注 于 过 程 以 确保 制造 质量 ， 即 力图 确保 以 正 
确 的 方式 做 正确 的 事情 。 









































质量 检查 过 去 扮演 的 角色 更 重要 , 但 随 着 TDD、 验 收 测试 驱动 开发 ( ATDD ) 
> 和 行为 驱动 开发 ( BDD ) 的 面世 ， 重 点 正 转 向 质量 保证 。 


1.2.4 ”更 好 的 测试 
无 论 使 用 黑 盒 测试 、 白 盒 测 试 还 是 两 者 兼 而 有 之 ， 编 写 测试 的 顺序 都 非常 重要 。 


需求 (规范 和 用 户 故 事 ) 是 在 实现 需求 的 代码 之 前 编写 的 ， 因 此 是 它们 定义 了 代码 ， 而 不 是 
相反 。 对 测试 来 说 亦 如 此 。 如 果 它 们 是 在 代码 之 后 编写 的 ,那么 从 某 种 意义 上 说 ,是 代码 ( 及 其 
实现 的 功能 ) 定义 了 测试 。 由 既 有 应 用 程序 定义 的 测试 有 失 偏 颇 , 倾向 于 确认 代码 的 功能 ， 而 不 
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查 客户 的 期 望 是 否 得 到 满足 , 或 者 说 代码 的 行为 是 否 符合 预期 。 如 果 是 手动 测试 , 这 种 倾向 
不 那么 严重 ， 因 为 手动 测试 通常 由 独立 的 QC ( 即使 通常 称 为 QA ) 部 门 来 做 。 这 种 部 门 以 独 
开 
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是 检 
可 能 
立 于 

宗 
































发 人 员 的 方式 定义 测试 ,这 将 导致 更 严重 的 问题 ， 因 为 必然 会 出 现 部 门 间 沟 通 不 畅 和 “和 警 
察 综 合 征 ”的 问题 。 所 谓 “ 警 察 综合 征 ” 是 指 , 测试 人 员 不 力图 去 帮助 开发 团队 编写 有 质量 保证 
的 应 用 程序 ， 而 只 会 在 流程 结束 后 找茬 。 问 题 发 现 得 越 时 ， 为 修复 而 付出 的 代价 越 低 。 


以 TDD (包括 其 ATDD 和 BDD 等 变种 ) 编写 的 测试 站 在 未 雨 绸 缘 , 将 问题 消 
~ 灭 在 


























萌芽 状态 ， 确 保 开 发 的 应 用 程序 从 根本 上 有 质量 保证 。 


1.3 ”模拟 


要 让 测试 能 够 快速 运行 并 不 断 提供 反馈 , 必须 以 合适 的 方式 组 织 代 码 , 以 便 能 够 轻松 使 用 模 
拟 对 象 mock ) 和 存根 ( stub ) 替换 方法 、 函 数 和 类 。 这 种 替换 实际 代码 的 方式 通常 称 为 “测试 
替身 ”。 外 部 依赖 可 能 严重 影响 执行 速度 ， 例 如 ， 代 码 可 能 需要 与 数据 库 通 信 。 通 过 模拟 外 部 依 
赖 ， 可 大 幅 提 高 速度 。 整 个 单元 测试 集 的 执行 时 间 应 以 分 钟 力 至 秒 计 。 要 想 轻松 使 用 模拟 对 象 和 
存根 ， 必 须 分 离 关 注 点 以 优化 代码 结构 。 


除 可 提高 速度 外 ， 消 除外 部 依赖 还 有 其 他 更 重要 的 好 处 。 代 码 的 外 部 依赖 可 能 包括 数据 库 、 
Web 服 务 器 、 外 部 API 等 ， 这 些 外 部 依赖 不 但 不 可 靠 ， 而 且 访 问 需要 很 长 时 间 。 在 很 多 情况 下 ， 
这 些 外 部 依赖 还 可 能 不 是 现成 的 , 例如 ,你 可 能 需要 编写 与 数据 库 通 信 的 代码 ,并 让 人 创建 数据 
库 模式 〈schema )。 如 果 不 使 用 模拟 对 象 ， 就 只 能 等 到 模式 就 绪 后 再 测试 。 
























































» 无 论 是 否 使 用 模拟 对 象 ， 都 应 以 合适 的 方式 编写 代码 , 以 便 能 够 轻松 用 一 个 
依赖 对 象 替换 另 一 个 依赖 对 象 。 


1.4 可 执行 的 文档 


TDD (以 及 更 多 结构 良好 的 测试 ) 另 一 个 很 有 用 的 方面 是 文档 。 要 搞 清 楚 代码 是 干什么 的 ， 
在 大 多 数 情 况 下 通过 查看 测试 比 查 看 实现 本 身 要 容易 得 多 。 一 些 方法 的 作用 是 什么 ?查看 与 之 相 
关联 的 测试 。 应 用 程序 某 部 分 UI 的 功能 是 什么 ?查看 与 之 相关 联 的 测试 。 以 测试 方式 编写 的 文档 
是 TDD 的 支柱 之 一 ， 有 必要 更 深入 地 了 解 。 


传统 软件 文档 存在 的 主要 问题 是 ,它们 通常 都 不 是 最 新 的 。 一 部 分 代码 发 生变 化 后 , 文档 便 
不 再 反映 实际 情况 。 几 乎 任何 类 型 的 文档 都 如 此 ， 需 求 和 测试 用 例 受到 的 影响 最 大 。 
需要 为 代码 编写 文档 通常 意味 着 代码 本 身 写 得 不 好 。 另 外 , 不 管 你 如 何 努 力 , 文档 都 必然 会 
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开发 人 员 不 应 依赖 于 系统 文档 ,， 因 为 它 几 乎 在 任何 时 候 都 不 是 最 新 的 。 另 外 , 在 详尽 而 及 时 
地 描述 代码 方面 ， 没 有 任何 文档 比 代码 本 身 做 得 更 好 。 


将 代码 用 作文 档 并 不 意味 着 不 能 有 其 他 类 型 的 文档 , 关键 是 避免 重复 。 如 果 说 通过 阅读 代码 
可 获悉 系统 细节 ,那么 其 他 类 型 的 文档 可 提供 快速 指南 和 概述 。 非 代码 文档 应 回答 诸如 “系统 的 
总 体 目 标 是 什么 ” “系统 使 用 了 哪些 技术 ”等 问题 。 大 多 数 情况 下 ,简单 的 README 足 以 提供 开 
发 人 员 所 需 的 快速 入 门 指南 ; 对 新 来 者 而 言 , 项目 描述 、 环 境 搭 建 、 安 装 以 及 构建 和 打包 说 明 等 
部 分 很 有 用 。 至 于 其 他 方面 ， 代 码 就 是 “圣经 ”。 


实现 代码 提供 了 所 需 的 所 有 细节 ， 而 测试 代码 描述 了 产品 代码 背后 的 意图 。 















































| @ 测试 就 是 可 执行 的 文档 ， 而 TDD 是 创建 和 维护 这 种 文档 的 最 常用 方式 。 | 


My 

采用 了 某 种 持续 集成 (CI ) 时 , 不 正确 的 测试 文档 将 失败 并 迅速 得 到 修复 。CI 能 够 解决 测试 
文档 不 正确 的 问题 ,但 无 法 确保 所 有 功能 都 有 相关 文档 。 有 鉴于 此 ( 以 及 众多 其 他 原因 )， 应 以 
TDD 的 方式 创建 测试 文档 。 如 果 编 写实 现代 码 前 , 所 有 功能 都 以 测试 的 方式 做 了 定义 ， 且 所 有 测 
试 都 通过 ， 测 试 便 提 供 了 完整 而 最 新 的 信息 ， 可 供 开 发 人 员 使 用 。 


对 于 团队 的 其 他 成 员 ， 该 如 何 办 呢 ? 测试 人 员 、 客 户 、 产 品 经 理 等 都 不 是 程序 员 ， 
从 产品 代码 和 测试 代码 获取 所 需 的 信息 。 


前 面 说 过 , 最 常见 的 两 种 测试 是 黑 盒 测试 和 日 盒 测 试 。 这 种 划分 很 重要 ， 因 为 这 也 将 测试 人 
员 分 成 了 两 类 : 知道 如 何 编 写 或 至 少 阅读 代码 的 ( 白 盒 测试 ), 不 知道 如 何 编写 和 阅读 代码 的 
盒 测 试 ) 有 些 测试 人 员 两 种 测试 都 能 做 ， 但 通常 都 不 知道 如 何 编写 代码 ， 因 此 对 开发 人 员 来 说 
很 有 用 的 文档 对 他 们 来 说 毫 无 用 处 。 如 果 需 要 将 文档 与 代码 分 开 ， 单 元 测试 并 不 是 很 好 的 选择 ， 
这 正 是 BDD 横 空 出 世 的 原因 之 一 。 
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能 无 法 





























| BDD 可 在 保留 TDD 和 自动 化 的 优点 的 同时 ， 提 供 非 程序 员 所 需 的 文档 。 ] 


客户 必须 能 够 定义 系统 的 新 功能 , 还 必须 能 够 获取 有 关系 统 各 重要 方面 的 最 新 信息 。 因 此 文 
档 的 技术 性 不 能 太 强 ( 将 代码 作为 文档 不 可 行 )， 同 时 必须 在 任何 情况 下 都 是 最 新 的 。BDD 鬼 述 
( narrative ) 和 场景 (scenario ) 是 提供 这 种 文档 的 最 佳 方式 之 一 。BDD 故 事 可 作为 验收 标准 (在 
代码 之 前 编写 的 )， 可 频繁 执行 (最 好 每 次 提交 时 都 执行 )， 还 是 使 用 自然 语言 编写 的 ， 因 此 不 但 
在 任何 情况 下 都 是 最 新 的 ， 而 且 可 供 那 些 不 想 研 究 代码 的 人 使 用 。 


文档 是 软件 不 可 分 割 的 一 部 分 ， 与 代码 一 样 需 要 经 常 测试 ， 这 样 才能 确保 它 既 准确 又 是 最 
新 的 。 
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统 的 可 执行 文档 。 


| 要 提供 既 准 确 又 是 最 新 的 信 息 ,唯一 划算 的 方式 是 使 用 可 集成 到 持续 集成 系 | a 











作为 一 种 方法 论 , TDD 提 供 了 实现 这 种 目标 的 良好 途径 。 在 底层 , 单元 测试 是 最 佳 的 可 执行 
文档 ; 而 在 功能 层面 , BDD 是 提供 可 执行 文档 的 不 错 方式 ， 它 使 用 自然 语言 ， 确 保 了 这 种 文档 易 
于 理解 。 











1.5 无需 调 试 


作者 几乎 从 未 调试 过 自己 编写 的 应 用 程序 ! 这 好 像 不 可 思议 , 但 情况 确实 如 此 。 我 们 几乎 从 
不 调试 应 用 程序 ,因为 没有 理由 这 样 做 。 在 编写 代码 前 编写 测试 且 代 码 覆 盖 率 很 高 的 情况 下 ,我 
们 完全 可 以 相信 应 用 程序 将 像 预 期 的 那样 工作 。 这 并 不 意味 着 使 用 TDD 编 写 的 应 用 程序 没有 
bug 一 一 bug 肯 定 是 有 的 ， 所 有 应 用 程序 都 有 bug; 但 出 现 bug 时 ， 可 轻松 地 找 出 它 介 只 需 
未 被 测试 覆盖 的 代码 即 可 。 


测试 本 身 可 能 没有 涵盖 某 些 情形 。 在 这 种 情况 下 ， 应 对 措施 是 编写 额外 的 测试 
















































































KW 代码 履 盖 率 很 高 的 情况 下 , 与 逐 行 调试 直到 找到 罪魁 祸首 相 比 , 通过 测试 找 
出 导致 bug 的 原因 要 快 得 多 。 


1.6 小结 
通过 阅读 本 章 , 你 对 测试 驱动 开发 实践 有 了 大 致 的 认识 , 还 知道 了 什么 是 真正 的 TDD。 你 了 
解 到 TDD 是 一 种 代码 设计 方法 ， 这 是 通过 简短 而 可 重复 的 “ 红 灯 - 绿 灯 - 重 构 ” 周 期 进行 的 。 


整个 TDD 过 程 中 ,“ 测 试 未 通过 ”都 是 一 种 意料 之 中 的 状态 ， 你 不 但 应 该 欣然 接受 ， 还 需 想 
办 法 进入 这 种 状态 。 " 红 灯 - 绿 灯 - 重 构 ” 周 期 很 得 ， 从 一 个 阶段 切换 到 另 一 个 阶段 的 速度 极 快 。 
虽然 主要 目标 是 代码 设计 , 但 TDD 过 程 中 创建 的 测试 是 宝贵 的 财产 , 应 充分 利用 ,它们 还 会 
严重 影响 我 们 对 传统 测试 实践 的 看 法 。 对 于 这 些 实践 , 我们 对 其 中 最 常用 的 几 个 〈 如 黑 盒 测 试 和 
盒 测试 ) 做 了 简单 的 介绍 ， 试 图 从 TDD 的 角度 审视 它们 ， 并 指出 了 它们 带 来 的 好 处 。 
你 发 现 模拟 对 象 是 非常 重要 的 工具 ,对 编写 测试 来 说 常常 必 不 可 少 。 最 后 ,我们 讨论 了 可 以 
也 应 该 将 测试 用 作 可 执行 的 文档 ， 还 有 TDD 如 何 极 大 地 减少 了 调试 的 必要 性 。 


介绍 必要 的 理论 知识 后 ， 下 面 搭建 开发 环境 、 概 述 并 比较 各 种 测试 框架 和 工具 。 
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第 2 章 
工具 、 框 架 和 环境 








“你 看 到 的 是 什么 ， 你 就 是 什么 样 的 人 ; 我 们 塑造 工具 ， 然 后 又 为 工具 所 塑造 。” 
一 一 马 软 尔 . 麦克 卢 汉 
每 位 战士 都 熟悉 自己 的 武器 ， 同 样 ， 程 序 员 必 须 熟 悉 开发 生态 环境 以 及 简化 编程 的 工具 。 无 
论 你 是 否 在 工作 中 或 家 里 使 用 过 这 些 工具 , 都 有 必要 重新 审视 它们 ,并 比较 其 功能 和 优 缺 点 。 下 
面 概述 这 些 工具 ， 并 通过 创建 小 型 项 目 熟悉 其 中 的 几 个 。 


后 文 将 详细 介绍 这 些 工具 和 框架 ,此 处 不 再 袭 述 。 本 章 的 目标 是 热身 , 简要 介绍 它们 的 功能 
和 工作 原理 。 


本 童 涵盖 如 下 主题 。 


口 Git; 

口 虚拟 机 ; 

口 构建 工具 ; 

口 集成 开发 环境 ; 

口 单元 测试 框架 ; 

口 代码 覆盖 率 工具 ; 

口 模拟 框架 ; 

口 用 户 界面 测试 ; 

口 行为 驱动 开发 工具 、 框 架 和 环境 。 






































2.1 Git 


Git 是 最 受 欢迎 的 修订 控制 系统 ， 有 鉴于 此 ， 本 书 使 用 的 所 有 代码 都 存储 在 Bitbucket 
( https://bitbucket.org/ )。 如 果 你 还 没有 安装 Git， 请 现在 就 下 载 安装 。 它 提供 了 用 于 各 种 流行 操作 
系统 的 版 本 ， 这 些 都 可 在 http://git-sem.com 找 到 。 


很 多 图 形 用 户 界面 支持 Git， 其 中 包括 Tortoise ( https://code.google.com/p/tortoisegit )、Source 
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Tree (https:/www. sourcetreeapp.com ) 和 Tower (http:/www.git-tower.comy )。 


2.2 虚拟 机 


虽然 虚拟 机 不 在 本 书 讨论 范围 之 内 , 但 这 是 一 个 功能 强大 的 工具 , 对 良好 的 开发 环境 来 说 不 
可 或 缺 。 它 们 在 隔离 的 系统 中 提供 易于 使 用 的 动态 资源 ， 让 你 能 够 根据 需要 使 用 和 删除 。 这 让 开 
发 人 员 能 够 专注 于 手头 的 任务 ， 而 不 将 时 间 浪 费 在 从 头 创建 或 安装 所 需 的 服务 上 。 这 正 是 虚拟 机 
能 够 在 本 书 找到 用 武之 地 的 原因 : 使 用 它们 可 证 你 专注 于 代码 。 


为 确保 无 论 哪 种 操作 系统 都 能 搭建 出 相同 的 环境 ， 我 们 将 使 用 Vagrant 创 建 虚 拟 机 ， 并 使 用 
Docker 部 署 所 需 的 应 用 程序 。 介 绍 操 作 方 法 时 ,我 们 将 以 Ubuntu 操 作 系 统 为 例 ， 因 为 它 是 一 种 流 
行 而 常见 的 类 UNIX 系 统 ; 其 中 涉及 的 大 多 数 技术 都 独立 于 平台 ， 但 有 些 情况 下 ， 你 不 能 按 这 里 
介绍 的 做 ， 因 为 你 使 用 的 可 能 是 其 他 操作 系统 。 这 种 情况 下 ,你 需要 找 出 Ubuntu 与 你 使 用 的 操作 
系统 的 不 同 之 处 ， 并 采取 相应 的 措施 。 





























2.2.1 Vagrant 


我 们 将 使 用 Vagrant 创 建 开 发 环境 栈 , 它 提 供 了 预 置 的 盒子 (box ), 能 够 轻松 初始 化 现成 的 虚 
拟 机 。 所 有 盒子 和 配置 都 放 在 名 为 Vagrantfile 的 文件 中 。 


下 面 的 示例 创建 一 个 简单 的 Ubuntu 盒子 ， 我 们 在 其 中 添加 了 使 用 Docker 安 装 MongoDB 的 配 
置 ( 稍 后 将 介绍 如 何 使 用 Docker )。 假 设 你 在 计算 机 中 安装 了 VirtualBox ( https://www.virtualbox. 
org ) 和 Vagrant ( https://www.vagrantup.com )， 还 能 访问 互联 网 。 











这 个 示例 中 ， 我 们 使 用 Ubuntu 盒子 (ubuntu/trusty64 ) 创建 了 一 个 64 位 的 Ubuntu 实例 ， 
并 将 这 个 虚拟 机 的 内 存 设 置 为 1 GB : 





config.vm.box = "ubuntu/trusty64" 


config.vm.provider "virtualbox" do |vb| 
vb.memory = "1024" 
end 


接 下 来 ， 我 们 在 这 个 Vagrant 虚 拟 机 中 暴露 MongoDB 默 认 使 用 的 端口 ， 并 使 用 Docker 运 行 
MongoDB : 








config.vm.network "forwarded port", guest: 27017, host: 27017 
config.vm.provision "docker" do |dl| 

d.run "mongoDB", image: "mongo:2", args: "-p 27017:27017" 
end 


最 后 ， 为 提高 Vagrant 的 安装 速度 ， 我 们 将 缓存 一 些 资源 。 为 此 ， 需 要 安装 插件 cachier， 有 
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关 该 插件 的 更 详细 信息 ， 请 参 


if Vagrant.has_plugin? ("vagrant-cachier") 
config.cache.scope = :box 
end 


下 面 启动 这 个 虚拟 机 。 首 次 启动 虚拟 机 时 ,通常 需要 几 分 钟 ， 因 为 需要 下 载 并 安装 基本 盒子 
和 所 有 的 依赖 项 : 

$> vagrant plugin install vagrant-cachier 

$> git clone thttps://bitbucket.org/vfarcic/tdd-java-ch02-example-vagrant.git 


$> cd tdd-java-ch02-example-vagrant 
$> vagrant up 


运行 这 个 命令 时 ， 输 出 如 下 : 





阅 https://github.com/fgrehm/vagrant-cachier。 




















vfarcic@viktor:~/IdeaProjects/tdd-java-ch82-example-vagrant$ vagrant Up 
Bringing machine "default' up with 'virtualbox' provider... 

==> default: Importing base box 'ubuntu/trusty64"'... 

==> default: Matching MAC address for NAT networking... 

==> default: Checking if box 'ubuntu/trusty64' is up to date... 


==> default: Setting the name of the VM: tdd-java-ch62-exampLe-vagrant_defauLt_1435347519969_47646 
==> default: Clearing any previously set forwarded ports... 
==> default: Clearing any previously set network interfaces... 
==> default: Preparing network interfaces based on configuration... 
default: Adapter 1: nat 
==> default: Forwarding ports... 
default: 27617 => 27017 (adapter 1) 
default: 22 => 2222 (adapter 1) 
==> default: Running 'pre-boot' VM customizations... 
==> default: Booting VM... 
==> default: Waiting for machine to boot. This may take a few minutes... 
default: SSH address: 127.0.0.1:2222 
default: SSH username: vagrant 
default: SSH auth method: private key 
default: Warning: Connection timeout. Retrying... 
default: 
default: Vagrant insecure key detected. Vagrant will automatically replace 
default: this with a newly generated keypair for better security. 
default: 
default: Inserting generated public key within guest... 
default: Removing insecure key from the guest if its present... 
default: Key inserted! Disconnecting and reconnecting using new SSH key... 
==> default: Machine booted and ready! 
==> default: Checking for guest additions in VM... 
==> default: Mounting shared folders... 
default: /vagrant => /home/vfarcic/IdeaProjects/tdd-java-ch92-exampLe-vagrant 
default: /tmp/vagrant-cache => /home/vfarcic/ .vagrant.d/cache/ubuntu/trusty64 
==> default: Configuring cache buckets... 
==> default: Running provisioner: docker... 
default: Installing Docker (latest) onto machine... 
default: Configuring Docker to autostart containers... 
==> default: Starting Docker containers... 
==> default: -- Container: mongoDB 
==> default: Configuring cache buckets... 
vfarcic@viktor:~/IdeaProjects/tdd-java-che2-example-vagrant$ 目 


请 耐心 等 待 执 行 完 毕 。 这 个 命令 执行 完毕 后 ， 你 就 有 一 个 新 的 虚拟 机 ， 它 使 用 的 是 Ubuntu 
操作 系统 ， 安 装 了 Docker ， 并 运行 着 一 个 MongoDB 实 例 。 最 重要 的 是 ， 所 有 这 些 都 是 使 用 一 个 
命令 实现 的 。 
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要 查看 当前 运行 的 VM 的 状态 ， 可 使 用 参数 status: 





$> vagrant status 
Current machine states: 
default running (virtualbox) 


要 访问 虚拟 机 ， 可 使 用 ssH， 也 可 使 用 Vagrant 命 令 ， 如 下 所 示 : 








$> vagrant ssh 
Welcome to Ubuntu 14.04.2 LTS (GNU/Linux 3.13.0-46-generic x86 64) 


* Documentation: https://help.ubuntu.com/ 
System information disabled due to load higher than 1.0 


Get cloud support with Ubuntu Advantage Cloud Guest: 
http://ww.ubuntu.com/business/services/cloud 


0 packages can be updated. 
0 updates are security updates. 


vagrant@vagrant-ubuntu-trusty-64:~$ 


最 后 ， 要 让 虚拟 机 停止 运行 ， 可 先 退 出 ， 再 执行 命令 vagrant halt: 




















$> exit 

$> vagrant halt 

==> default: Attempting graceful shutdown of VM... 
$> 


https://www.vagrantup.com。 


| 有 关 详 尽 的 Vagrant 盒 子 列 表 以 及 如 何 配置 Vagrant 的 更 详细 信息 ， 请 参见 
Pe 


2.2.2 Docker 








搭建 好 环境 后 ， 安 装 所 需 的 服务 和 软件 。 为 此 可 使 用 Docker， 它 提供 了 一 种 在 隔离 的 容器 中 
安装 并 运行 众多 应 用 程序 的 便捷 方式 。 在 前 面 使 用 Vagrant 创 建 的 虚拟 机 中 ， 我 们 将 使 用 Docker 
安装 本 书 所 需 的 数据 库 、Web 服 务 器 和 其 他 应 用 程序 。 实 际 上 ， 前 面 创 建 Vagrant VM 时 ， 已 经 演 
示 了 如 何 使 用 Docker 安 装 并 运行 MongoDB 实 例 。 








下 面 重启 这 个 VM ( 因为 前 面 使 用 命令 vagrant nalt 停 止 了 它 ) 和 MongoDB: 


$> vagrant up 

$> vagrant ssh 

vagrant@vagrant-ubuntu-trusty-64:~$ docker start mongoDB 
vagrant@vagrant-ubuntu-trusty-64:~$ docker ps 

CONTAINER ID IMAGE COMMAND CREATED 
360f5340d5fc mongo :2 "/entrypoint .sh mong 41 minutes ago 
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STATUS PORTS NAMES 
Up 41 minutes 0.0.0.0:27017->27017/tcp mongoDB 
vagrant@vagrant-ubuntu-trusty-64:~$ exit 


我 们 使 用 命令 docker start 启 动容 器 ， 青 使 用 命令 docker ps 列 出 当前 运行 的 所 有 进程 。 


通过 这 个 流程 ,可 在 刀 眼 之 间 重 建 一 个 全 栈 环境 。 你 可 能 想 知 道 , 这 真 的 像 看 起 来 那么 神奇 
吗 ? 管 案 是 肯定 的 。Vagrant 和 Docker 让 开发 人 员 能 够 专注 于 该 做 的 事情 , 不 用 操心 复杂 的 安装 和 
环 手 的 配置 。 另 外 ,我 们 做 了 额外 的 工作 ， 以 提供 所 有 必要 的 步 又 和 资源 ， 让 你 能 够 重建 并 测试 
本 书 所 有 代码 示例 和 演示 程序 。 









































2.3 构建 工具 


随 着 时 间 的 推移 ,代码 的 规模 和 复杂 程度 通常 呈 增 长 趋势 。 这 是 软件 行业 的 性 质 决 定 的 : 所 
有 产品 都 在 生命 周期 内 不 断 演进 一 一 实现 客户 提出 的 新 需求 。 构 建 工 具 最 大 限度 简化 了 项 目 生 命 
周期 的 管理 工作 , 它 要 求 你 遵循 一 些 编码 约定 , 如 以 特定 方式 组 织 代码 、 采 用 特定 的 类 命名 约定 、 
将 各 种 文件 夹 和 文件 组 织 成 特定 的 项 目 结构 。 


有 些 读者 可 能 熟悉 Maven 或 Ant， 它 们 都 是 项 目 处 理 方面 的 “瑞士 军刀 ”, 但 本 书 的 主要 目标 
是 介绍 TDD， 因 此 我 们 决定 使 用 Gradle。Gradle 的 优点 之 一 是 样板 式 代码 较 少 ， 因 此 其 配置 文件 
更 简短 、 更 易于 理解 。Gradle 还 是 Google 使 用 的 构建 工具 之 一 。 它 得 到 Intellij IDEA 的 支持 ,学 习 
和 使 用 都 非常 容易 ， 且 大 部 分 功能 和 任务 都 是 通过 插件 提供 的 。 





































































































精通 Gradle 并 非 本 书 的 目标 ， 如 果 你 要 更 深入 地 学 习 这 款 出 色 的 工具 ， 请 访 
问 其 官网 (http://gradle.org/ )， 了 解 可 使 用 的 插件 和 可 定制 的 选项 。 有 关 各 种 Java 
> 构建 工具 的 比较 ,请 参阅 http://technologyconversations.com/2014/06/18/build-tools/。 
接着 往 下 阅读 前 ， 请 确认 你 的 系统 安装 了 Gradle。 





下 面 分 析 一 个 buila.gradle 文 件 中 相关 的 部 分 。 这 种 文件 以 简洁 的 方式 存储 了 项 目 信 息 ， 
使 用 的 描述 符 语言 为 Groovy。 下 面 是 我 们 项 目的 构建 文件 ， 这 是 由 Intell 订 自动 生成 的 : 
apply plugin: 'Jjava' 


sourceCompatibility = 1.7 
VErSTON e140 


由 于 这 是 一 个 Java 项 目 ， 因 此 应 用 了 一 个 Java 搬 件 ， 这 让 你 能 够 执行 常见 的 Java 任 务 ， 如 构 


















































建 、 打 包 、 测 试 等 。 源 代码 兼容 性 被 设置 为 JDK 7， 因 此 如 果 你 使 用 了 这 个 版 本 不 支持 的 Java 语 
言 ， 编 译 需 将 提出 抗议 。 
repositories { 


mavenCentral () 


} 
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Maven Central ( http://search.maven.org/ ) 存储 了 我 们 项 目的 所 有 依赖 项 ， 这 部 分 告诉 Gradle 
去 哪里 获取 这 些 依 赖 项 。 就 这 个 项 目 而 言 ，Maven Central 仓 库 足 够 了 ; 但 如 果 需 要 ， 你 也 可 添加 
自 定 义 仓库 ， 如 Nexus 和 ivy。 


dependencies { 
testCompile group: 'junit', name: 'junit', version: '4.12' 区 
} 


最 后 ， 这 部 分 演示 了 如 何 声 明 项 目的 依赖 项 一 一 IntelliJ 决 定 使 用 测试 框架 JUnit。 


运行 Gradle 任 务 很 容易 ， 例 如 ， 要 从 命令 行 运行 测试 ， 只 需 执行 如 下 命令 : 








gradle test 


这 项 工作 也 可 在 IDEA 中 完成 : 选择 菜单 View > Tool Windows > Gradle 打 开 Gradle Tool 
Window， 再 运行 其 中 的 测试 任务 。 


测试 结果 存储 在 目录 build /reports/tests 下 的 HTML 文件 中 。 


下 面 是 对 示例 代码 执行 命令 gradle test 生 成 的 测试 报告 。 

















Class com.packtpublishing.tddjava.ch02friendships.FriendshipsTest 


all > com.packtpublishing.tddjava.ch02friendships > FriendshipsTest 


3 0 0 0.016s 100% 
tests failures ignored duration 
successful 





Tests 
Test Duration Result 
alexDoesNotHaveFriends 0.013s passed 
joeHas5Friends 0.002s passed 
joelsFriendWithEveryone 0.001s passed 
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鉴于 本 书 介绍 的 工具 和 技术 很 多 ， 我 们 推荐 使 用 PtelliJ IDEA 开 发 代码 ， 主 要 是 因为 这 个 
IDE 不 要 求 做 繁琐 的 配置 。 其 社区 版 ( IntelliJIDEA CE ) 自 带 了 大 量 内 置 功能 和 插件 ， 让 你 能 
够 轻松 而 高 效 地 编写 代码 。 它 根据 扩展 名 自动 推荐 可 安装 的 插件 。 由 于 本 书 使 用 的 是 IntelliJ 
IDEA， 因 此 介绍 相关 步骤 时 ， 说 的 都 是 在 IntelliJ IDEA 中 如 何 做 ;如 果 你 使 用 的 是 其 他 IDE， 
则 应 采取 相应 的 方式 执行 这 些 步 又 。 有 关 如 何 下 载 并 安装 IntelliJ IDEA ， 请 参阅 https:/www. 
Jetbrains.com/idea/。 
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IDEA 演示 项 目 

下 面 创建 演示 项 目的 基本 布局 。 本 章 始终 都 将 通过 这 个 项 目 演 示 涉 及 的 各 种 主题 。 这 个 项 目 
将 Java 用 作 编 程 语言 ， 并 使 用 Gradle (http:/gradle.org/ ) 执行 各 种 任务 ， 如 构建 、 测 试 等 。 

下 面 将 包含 本 章 示例 的 仓库 导入 IDEA。 


(1) 启动 IntelliJ IDEA， 选 择 Check out from Version Control 并 单 击 Git。 

(2) 在 文本 框 Git repository URL 中 输入 https://bitbucket.org/vfarcic/tdd-java-ch02-example- 
junit.git， 单 击 Clone。 不 断 确认 IDEA 提 出 的 问题 ， 直 到 使 用 从 前 述 Git 仓 库 克 隆 的 代码 新 建 一 个 
项 目 。 


导入 的 项 目 类 似 下 图 。 






































后 Project 划 四 幸 | 将 -I 
Cs tdd-java-ch02-example-junit [projectJ 
口 ,idea 
记 src 
口 main 
口 java 
” DH com.packtpublishing.tddjay 
日 b FriendsCollection 
Sb Friendships 
9 b FriendshipsMongo 
Sb Person 
口 java 
思 com.packtpublishing.tddjay 
二 b FriendshipsAssertJTeqd 
二 FriendshipsHamcrestT 
二 FriendshipsMongoAssd 
二 FriendshipsMongoEas 
者 b FriendshipsTest 
二 5 PersonTest 
© .ditignore 
S build.gradle 
目 LICENSE 
引 projectJUnit.iml 
3 settings.gradle 
>» 顺 ExternalLibraries 





M1: Project 





«7: Structure 


a 
uy 
| 
5 
4 
由 
Ril 





育 


项 目 创建 好 后 ， 该 看 看 单元 测试 框架 了 。 











2.5 ”单元 测试 框架 

本 节 简 要 介绍 两 个 最 常用 的 Java 单 元 测试 框架 一 一 JUnit 和 TestrNG， 重 点 是 通过 比较 使 用 它 
们 编写 的 测试 类 阐述 二 者 语法 和 主要 功能 ,虽然 存在 细微 的 差别 一 一 主要 是 执行 和 组 织 测试 的 方 
式 ， 但 这 两 个 框架 都 提供 了 最 常用 的 功能 。 
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我 们 从 一 个 问题 着 手 : 测试 是 什么 ?如 何 定义 ? 


逐 和 测试 是 一 个 可 重复 的 过 程 或 方法 ,用 于 验证 受 测 对 象 在 指定 环境 下 的 行为 是 
否 正确 ， 即 向 它 提供 指定 的 输入 ， 





阻 领域 有 多 种 范围 不 同 的 测试 : 功能 测试 、 验 收 测试 和 单元 测试 , 后 面 将 更 深入 地 探索 这 
些 测试 类 型 。 


单元 测试 虽 在 对 一 小 块 代码 进行 测试 。 下 面 看 看 如 何 测试 一 个 Java 类 ， 这 个 类 很 简单 ， 但 足 
以 激发 你 的 兴 


public class Friendships { 
private final Map<String, List<String>> friendships = 
new HashMap<>(); 


public void makeFriends (String personl, String person2) { 
addFriend (personl, person2); 
addFriend (person2, personl); 


} 


public List<String> getFriendsList(String person) { 
if (!friendships.containsKey (person)) { 
return Collections.emptyList(); 
} 
return friendships.get (person); 


} 


public boolean areFriends (String personl, String person2) { 
return friendships.containsKey (DerSon1) && 
friendships.get (person1) .contains (person2); 


} 


private void addFriend(String person, String friend) { 
if (!friendships.containsKey (person)) { 
friendships.put (person, new ArrayList<String>()); 





} 
List<String> friends = friendships.get (person); 
if (!friends.contains (friend)) { 
friends.add (friend); 
} 
j: 
} 
2.5.1 JUnit 
JUnit( http://junit.org/ ) 是 一 个 用 于 编写 和 运行 测试 的 框架 ,简单 易学 。 每 个 测试 都 是 一 个 








方法 ， 包 含 特定 场景 下 将 执行 的 部 分 代码 。 比 较 预 期 输出 (行为 ) 和 实际 输出 (行为 )， 以 实现 
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代码 验证 。 

下 面 是 使 用 JUnit 编 写 的 测试 类 , 其 中 并 非 涵盖 所 有 场景 , 但 这 里 要 做 的 是 让 你 知道 测试 长 什 
么 样 。 更 佳 的 测试 方式 和 最 佳 实践 将 在 后 面 介绍 。 

测试 类 通常 包含 三 个 阶段 : 准备 、 测 试 和 清理 。 下 面 先 来 看 看 为 测试 准备 数据 的 方法 。 准 备 
工作 可 在 类 层面 执行 ， 也 可 在 方法 层面 执行 : 























Friendships friendships; 


@BeforeClass 

public static void beforeClass() { 
// 这 个 方法 仅 在 初始 化 阶段 执行 一 次 

} 


@Before 

public void before() { 
friendships = new Friendships(); 
friendships.makeFriends ("Joe", "Audrey"); 
friendships.makeFriends ("Joe", "Peter"); 
friendships.makeFriends ("Joe", "Michael"); 
friendships.makeFriends ("Joe", "Britney"); 
friendships.makeFriends ("Joe", "Paul"); 


} 
注解 eBeforeclass 指 定 , 方法 只 在 执行 类 中 的 测试 方法 前 执行 一 次 ,非常 适合 用 于 执行 
部 分 乃至 全 部 测试 都 要 求 的 一 般 性 准备 工作 。 


注解 aBefore 指 定 , 方法 将 在 每 个 测试 方法 前 运行 , 可 使 用 它 准备 测试 数据 ， 这 样 就 不 用 担 
心 后 面 运 行 的 测试 修改 数据 状态 。 前 面 的 示例 中 ， 我 们 实例 化 Friengdships 类 ， 并 在 这 个 对 象 
的 列表 中 添加 5 个 元 素 。 不 管 各 个 测试 将 做 什么 样 的 修改 ， 都 将 反复 重建 这 些 数据 ， 直 到 所 有 测 
试 都 执行 完毕 。 

这 两 种 注解 常用 于 准备 数据 库 数据 、 创 建 测试 所 需 的 文件 等 。 本 书后 面 将 介绍 如 何 使 用 模拟 
对 象 消除 外 部 依赖 ， 但 功能 测试 和 集成 测试 可 能 需要 外 部 依赖 项 ， 而 注解 eBefore 和 
eBeforeclass 非 常 适合 用 于 创建 它们 。 


准备 好 数据 后 ， 执 行 实际 测试 : 


@Test 
public void alexDoesNotHaveFriends() { 
Assert.assertTrue("Alex does not have friends", 
friendships.getFriendsList ("Alex").isEmpty()); 























} 
@Test 


public void joeHas5Friends() { 
Assert.assertEquals ("Joe has 5 friends", 5, 
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friendships.getFriendsList ("Joe").size()); 


} 


@Test 
public void joeIsFriendWithEveryone() { 
List<String> friendsOfJoe = 
Arrays.asList ("Audrey", "Peter", "Michael", "Britney", "Paul"); 
Assert.assertTrue (friendships.getFriendsList ("Joe") 
.containsAll (friendsOfJoe)); 


} 


这 个 示例 中 ,我 们 使 用 了 众多 断言 中 的 几 个 。 我 们 确认 Alex 确 实 没 朋 友 ， 而 Joe 很 讨 人 喜欢 ， 
有 5 个 朋友 ( Audrey、Peter、Michael、Britrey 和 Paul )。 


最 后 ,测试 结束 后 ， 可 能 需要 做 些 清理 工作 : 


@AfterClass 
public static void afterClass() { 


// 这 个 方法 仅 在 所 有 测试 者 执行 完毕 后 执行 一 次 
} 


@After 
public void after() { 
// 这 个 方法 在 每 个 测试 执行 完毕 后 都 执行 
} 
我 们 的 示例 (Friendships 类 ) 中 ， 无需 做 任何 清理 工作 ,但 有 这 种 需求 的 情况 下 ， 这 两 

种 注解 可 提供 所 需 的 功能 。 它 们 的 工作 原理 类 似 于 注解 eBefore 和 8eBeforeclass 。 
QAfterclass 指 定 的 方法 在 所 有 测试 都 结束 后 运行 一 次 ， 而 注解 EAfter 指 定 的 方法 在 每 个 测试 
结束 后 都 执行 。 前 面 的 示例 中 ,每 个 测试 方法 都 是 在 独立 的 类 实例 中 执行 的 。 因 此 只 要 没有 使 用 
全 局 变量 和 外 部 资源 ( 如 数据 库 和 API )， 这 些 测试 都 将 是 彼此 隔离 的 ， 即 不 管 一 个 测试 做 什么 ， 
都 不 会 影响 其 他 测试 。 











完整 的 源 代码 可 在 FriendshipsTest 类 中 找到 ， 这 个 类 包含 在 仓库 https://github.com/ 
TechnologyConversations/tdd-java-ch02-example-junit.git 和 https://bitbucket.org/vfarcic/tdd-java-ch02- 
example-junit.git 中 。 


2.5.2 TestNG 


TestNG ( http://testng.org/doc/index.html ) 中 ， 测 试 被 组 织 成 类 ， 这 与 JUnit 中 完全 相同 。 
要 运行 TestNG 测 试 ， 必 须 添加 下 面 的 Gradle 配 置 ( build.gradle): 





dependencies { 
testCompile group: 'org.testng', name: 'testng', version: '6.8.21' 


} 


test.useTestNG(){ 
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// 你 可 使 用 exclude/include 过 滤器 指定 要 执行 哪些 测试 
//excludeGroups 'complex' 


} 
不 同 于 JUnit， 要 使 用 TestNG 运 行 测试 ， 必 须 添加 额外 的 Gradle 配 置 。 


下 面 的 测试 类 是 使 用 TestNG 编 写 的 ， 其 中 包含 的 测试 与 前 面 使 用 JUnit 所 做 的 完全 相同 。 这 
里 省 略 了 重复 的 导入 和 其 他 烦人 的 部 分 ， 旨 在 专注 于 相关 部 分 : 


























@BeforeClass 

public static void beforeClass() { 
// 这 个 方法 仅 在 初始 化 阶段 执行 一 次 

} 


@BeforeMethod 

public void before() { 
friendships = new Friendships(); 
friendships.makeFriends ("Joe", "Audrey"); 
EASndS hn De akerr rend Toe "Peter"); 
friendships.makeFriends ("Joe "Michael"); 
friendships.makeFriends ("Joe "Britney"); 
friendships.makeFriends ("Joe "Paul"); 








你 可 能 注意 到 了 JUnit 和 TestNG 的 相似 之 处 。 它 们 都 使 用 注解 指定 方法 的 用 途 ， 且 除 注解 名 
二 fore 和 @BeforeM i 没有 其 他 不 同 。 然而, 不 同 于 JUnit，TestNG 使 用 同一 个 
测试 类 实例 执行 所 有 测试 方法 。 这 意味 着 测试 方法 默认 不 是 彼此 隔离 的 , 因此 编写 测试 前 后 执行 
的 方法 时 需要 更 加 小 心 。 


断言 也 很 像 : 


public void alexDoesNotHaveFriends() { 
Assert.assertTrue (friendships.getFriendsList ("Alex") .isEmpty() ， 
"Alex does not have friends"); 
} 
public void joeHas5Friends() { 
Asert.assertEquals (friendships.getFriendsList ("Joe").size(), 
5, "Joe has 5 friends"); 




















} 


public void joeIsFriendWithEveryone() { 
List<String> friendsOfJoe = 
Arrays.asList("Audrey", "Peter", "Michael", "Britney", "Paul"); 


Assert.assertTrue (friendships.getFriendsList ("Joe") 
.containsAll (friendsOfJoe)); 


与 使 用 JUnit 相 比 ， 唯 一 明显 的 差别 是 断言 变量 的 排列 顺序 。JUnit 断 言 中 ， 参 数 依次 为 可 选 
的 消息 、 期 望 的 值 和 实际 值 ; 而 TestNG 断 言 中 , 依次 为 实际 值 、 期 望 的 值 和 可 选 的 消息 。 除 向 断 
言 方法 传递 参数 时 的 顺序 不 同 外 ，JUnit 和 TestNG 几 乎 没有 其 他 不 同 之 处 。 
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你 可 能 注意 到 了 ,这 里 没有 使 用 注解 erest。TestNG 中 ,可 在 类 层级 设置 这 一 点 ， 将 所 有 公 
有 方法 都 转换 为 测试 。 

eafter 注 解 也 很 像 。 唯 一 明显 的 差别 是 ， 与 JUnit 注 解 eafter 对 应 的 TestNG 注 解 为 
CAfterMethodo。 

正如 你 看 到 的 ，JUnit 和 TestNG 的 语法 很 像 。 测 试 被 组 织 成 类 ， 而 验证 是 使 用 断言 执行 的 。 
这 并 不 意味 着 这 两 个 框架 不 存在 重大 差别 ， 本 书后 面 将 介绍 其 中 的 一 些 。 建 议 你 自己 探索 JUnit 
( http://junit.org/ ) 和 TestNG ( http://testng.org/ )。 























前 述 示例 的 完整 源 代码 可 在 https://bitbucket.org/vfarcic/tdd-java-ch02-example-testng.git 找 到 。 


前 面 编写 所 有 断言 时 ， 都 只 使 用 了 测试 框架 , 但 有 些 测 试 工具 可 帮助 我 们 编写 更 漂亮 、 更 易 
于 理解 的 断言 。 























2.6 Hamcrest 和 AssertJ 




















前 一 节 中 ,我 们 概述 了 单元 测试 的 定义 及 如 何 使 用 两 种 最 常用 的 Java 框 架 进 行 编写 。 测 试 是 
项 目的 重要 部 分 ,为 何不 改进 其 编写 方式 呢 ? 一 些 出 色 的 项 目 应 运 而 生 , 由 在 通过 修改 做 出 断言 
的 方式 强化 测试 的 语义 ， 让 测试 更 简洁 、 更 易于 理解 。 





2.6.1 Hamcrest 





Hamerest 添 加 了 大 量 被 称 为 “匹配 器 ”的 方法 ,其 中 每 个 匹配 器 都 设计 用 于 执行 特定 的 比较 
操作 。Hamcrest 的 可 扩展 性 很 好 ， 让 你 能 够 创建 自 定 义 匹 配器 。 另 外 ，JUnit 发 布 版 包含 Hamcrest 
的 核心 ， 提 供 了 对 Hamcrest 的 原生 支持 ， 这 让 你 能 够 直接 使 用 Hamcrest。 但 我 们 要 使 用 功能 齐备 
的 Hamcrest， 因 此 需要 在 Gradle 配 置 文件 中 添加 如 下 测试 依赖 项 ， 








testCompile 'org.hamcrest:hamcrest-all:1.3' 
下 面 比 较 等 价 的 JUnit 源 言 和 Hamcrest 时 言 : 
口 JUnit 源 言 : 
List<String> friendsOfJoe = 
Arrays.asList ("Audrey", "Peter", "Michael", "Britney", "Paul"); 
Assert.assertTrue( friendships.getFriendsList ("Joe") 
.ContainsAll (friendsOfJoe) 
J 
口 Hamcrest 汤 言 : 


assertThat( 
friendships.getFriendsList ("Joe"), 
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containsInAnyOrder ("Audrey", "Peter", 
"Michael", "Britney", "Paul") 


) 。 


正如 你 看 到 的 ，Hamcrest 的 表达 力 强 些 。 它 提供 的 断言 多 得 多 ， 让 我 们 能 够 避免 一 些 样板 式 
代码 ， 同 时 让 代码 更 容易 理解 、 更 具 表达 力 。 


再 来 看 一 个 例子 : 


口 JUnit 源 言 : 








Assert.assertEquals(5, friendships.getFriendsList("Joe").size()); 


口 Hamcrest 新 言 : 


assertThat (friendships.getFriendsList ("Joe"), hasSize(5)); 











你 应 该 注意 到 了 两 个 不 同 之 处 ,首先 ,不 同 于 JUnit, Hamcrest 几 乎 总 是 直接 使 用 对 象 ; 而 JUnit 
中 ,需要 先 获取 整数 表示 的 长 度 ， 再 将 其 与 期 望 的 值 (5 ) 进行 比较 。Hamcrest 提 供 的 断言 更 多 ， 
让 我 们 可 将 其 中 的 一 个 (hassize ) 与 实际 对 象 ( List ) 结 合 使 用 。 另 一 个 不 同 之 处 是 , Hamcrest 
像 TestNG 一 样 反 转 了 参数 的 排列 顺序 ， 不 将 实际 值 作 为 第 一 个 参数 。 












































这 两 个 示例 不 足以 展现 Hamcrest 的 全 部 潜力 ， 本 书后 面 将 提供 更 多 示例 ， 并 对 Hamcerest 做 更 
详细 的 介绍 ,要 更 深入 地 了 解 其 语法 , 请 访问 https://code.google.com/p/hamcrest/ 或 http://hamcrest.org/。 


完整 的 源 代码 可 在 FriendshipsHamcrestTest 类 中 找到 ， 这 个 类 包含 在 仓库 
https://github.com/TechnologyConversations/tdd-java-ch02-example-junit.git 和 https://bitbucket.org/ 
vfarcic/tdd-java-ch02-example-junit.git 中 。 





2.6.2 AssertJ 











AssertJ 的 工作 原理 与 Hamcrest 类 似 ， 一 个 重要 的 差别 是 AssertJ 断 言 是 可 以 串 接 的 。 





要 使 用 AssertJ， 必 须 在 Gradle 配 置 文件 的 dependencies 部 分 添加 如 下 依赖 项 : 
testCompile 'org.assertj:assertj-core:2.0.0"' 


下 面 比较 JUnit 汤 言 和 AssertJ 汤 言 : 


Assert.assertEquals (5, friendships.getFriendsList("Joe'").size()); 
List<String> friendsOfJoe = 
Arrays.asList("Audrey", "Peter", "Michael", "Britney", "Paul"); 
Assert.assertTrue( friendships.getFriendsList ("Joe") 
.containsAll (friendsOfJoe) 
2 


AssertJ 中 ， 可 将 这 两 个 断言 串 接 成 一 个 : 
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assertThat (friendships.getFriendsList ("Joe")) 
.hasSize(5) 
.containsOnly ("Audrey", "Peter", "Michael", "Britney", 
"maul rT) 


这 是 很 大 的 改进 : 不 需要 两 个 独立 的 断言 , 也 无 需 使 用 期 望 的 值 新 建 一 个 列表 。 另外 ,AssertJ 
断言 的 可 读 性 更 强 ， 也 更 容易 理解 。 


完整 的 源 代码 可 在 FriendshipsAssertJTest 类 中 找到 ， 这 个 类 包含 在 仓库 https://github. 
com/TechnologyConversations/tdd-java-ch02-example- junit.git 和 https:/bitbucket.org/vfarcic/tdd-java- 





ch02-example-junit.git 中 。 
创建 并 运行 测试 后 ， 你 可 能 想 知 道 这 些 测试 的 代码 覆盖 率 有 多 高 。 





2.7 ”代码 覆盖 率 工 具 


编写 了 测试 并 不 意味 着 它们 很 好 , 也 不 意味 着 它们 的 代码 覆盖 率 足 够 高 。 开始 编写 并 运行 测 
试 后 , 一 种 自然 而 然 的 反应 是 开始 提出 以 前 不 会 问 的 问题 。 正 确 地 测试 了 代码 的 哪些 部 分 ?测试 
未 考虑 哪些 情形 ? 测试 够 详尽 吗 ? 要 回答 这 些 问 题 及 其 他 类 似 问题 , 可 使 用 代码 覆盖 率 工具 。 这 
些 工具 可 用 于 找 出 未 被 测试 覆盖 的 代码 块 或 代码 行 ， 它 们 还 能 够 计算 被 覆盖 的 代码 所 占 的 百 分 
比 ， 以 及 提供 其 他 有 趣 的 指标 。 

使 用 这 些 功能 强大 的 工具 可 获得 相关 的 指标 ， 找 出 测试 代码 并 实现 代码 之 间 的 关系 。 然 而 ， 
与 其 他 工具 一 样 , 这 里 有 必要 澄清 其 用 途 。 它 们 并 不 能 提供 质量 方面 的 信息 ， 而 只 能 告诉 你 哪些 
代码 经 过 了 测试 。 

































































代码 履 盖 率 工 具 能 够 指出 测试 执行 期 间 触 及 了 哪些 代码 行 ,但 并 不 能 保证 你 
遵循 了 良好 的 测试 实践 ， 因 为 这 些 指标 中 不 包含 测试 质量 。 








下 面 介 绍 一 个 最 受 欢迎 的 代码 覆盖 率 计算 工具 。 


JaCoCo 


Java Code Coverage (JaCoCo ) 是 一 个 著名 的 测试 覆盖 率 测量 工具 。 要 在 我 们 的 项 目 中 使 
用 它 ， 需 要 在 Gradle 配 置 文件 ( build.gradle ) 中 添加 几 行 内 容 : 

















(1) 添加 JaCoCo 插 件 : 


apply plugin: 'Jjacoco' 


(2) 为 查看 JaCoCo 的 结果 ， 从 命令 提示 符 运 行 如 下 命令 : 
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gradle test jacocoTestReport 


(3) 也 可 通过 IDEA Tool Window 执 行 这 个 任务 。 
(4) 最 终 的 结果 存储 在 目录 build/reports/jacoco/test/html 中 ， 这 是 一 个 HTML 文 件 ， 可 使 用 任 
何 浏览 器 打开 。 






































Friendships 

Element Missed Instructions*> Cov.$ Missed Branches Cov.$ Missed$ Cxtys Missed$ Lines$s Missed* Methods 
© areFriends(String, String) 0% | EEE 0% 3 8 1 1 1 1 
© addFriend(String, String) PE 100% BE 75% 1 3 0 4 0 1 
© getFriendsList(String) 一 一 100% ess 100% 0 量 0 2 0 1 
© makeFriends(String, String) mn 100% n/a 0 1 0 3 0 1 
© Friendships() 二 二 100% n/a 0 1 0 2 0 1 
Total 17 of 75 77% 5of10 50% 4 10 1 12 1 5 











本 书后 面 将 更 详细 地 介绍 JaCoCo， 届 时 可 访问 http://www.eclemma.org/jacoco/ 获 取 更 详细 的 


信息 。 


2.8 ”模拟 框架 


我 们 的 项 目 看 起 来 很 不 错 , 但 太 简 单 ， 与 真实 的 项 目 相 差 很 远 一 一 它 没有 使 用 外 部 资源 。 而 
Java 项 目 大 多 都 需要 使 用 数据 库 ， 下 面 就 来 引入 数据 库 。 


对 于 使 用 外 部 资源 或 第 三 方 库 的 代码 , 通常 如 何 测试 呢 ?” 答案 是 使 用 模拟 对 象 。 模 拟 对 象 是 
可 用 于 蔡 代 实 际 对 象 的 仿真 对 象 ， 在 依赖 的 外 部 资源 不 可 用 时 很 有 用 。 


事实 上 , 开发 应 用 程序 期 间 , 根本 不 需要 数据 库 。 你 可 使 用 模拟 对 象 提高 开发 和 测试 的 速度 ， 
仅 在 进入 运行 阶段 后 才 使 用 真正 的 数据 库 连 接 。 你 不 用 花 时 间 建 立 数据 库 和 准备 测试 数据 ,而 是 
专注 于 编写 类 ， 等 到 集成 阶段 再 考虑 这 些 问 题 。 


为 方便 演示 ， 我 们 将 引入 两 个 新 类 Person 和 FriendCollection。 持久 化 工作 将 使 用 
MongoDB ( https:/www.mongodb. org/ ) 完成 。 









































Person 类 表示 数据 库 对 象 数据 ， 而 Frienqcollection 将 充当 数据 访问 层 。 但 愿 这 些 类 的 
代码 是 不 言 自明 的 。 


下 面 创建 Person 类 .: 





public class Person { 
@Id 
private String name; 


private List<String> friends; 


public Person() { } 
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public Person(String name) { 
this.name = name; 
friends = new ArrayList<>(); 


} 


public List<String> getFriends() { 
return friends; 





} 


public void addFriend(String friend) { 
if (!friends.contains (friend)) friends.add (friend); 


} 
} 


接 下 来 创建 Frienqscollection 类 : 


public class FriendsCollection { 
private MongoCollection friends; 


public FriendsCollection() { 
try { 
DB db = new MongoClient() .getDB ("friendships"); 
friends = new Jongo(db) .getCollection("friends"); 
} catch (UnknownHostException e) { 
throw new RuntimeException(e.getMessage()); 
} 
} 


public Person findByName (String name) { 
return friends.findOone("{_id: #}", name) .as (Person.class); 


} 


public void save(Person p) { 
friends.save(p); 
} 
} 


另外 , 引入 了 一 些 新 的 依赖 项 , 因此 需要 修改 Gradle 配 置 文件 的 dependencies 部 分 。 第 一 个 依 
赖 项 是 MongoDB 驱 动 程序 ， 用 于 连接 到 数据 库 ; 第 二 个 是 Jongo， 能 够 轻松 访问 MongoDB 集 合 
的 小 型 项 目 。 


在 Gradle 配 置 文件 中 添加 依赖 项 MongopB 和 Jongo 的 代码 如 下 所 示 : 

















dependencies { 
compile 'org.mongodb:mongo-java-driver:2.13.2' 
compile 'org.jongo:jongo:1.1' 


} 


我 们 现在 使 用 了 数据 库 , 因此 必须 修改 Friendships 类 ,为 此 ,将 其 中 的 映射 改 为 Friends- 
Collection， 并 修改 使 用 它 的 其 他 代码 ， 最 终结 果 如 下 所 示 : 
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public class FriendshipsMongo { 
private FriendsCollection friends; 


public FriendshipsMongo() { 
friends = new FriendsCollection(); 


} 


public List<String> getFriendsList(String person) { 
Person p = friends.findByName (person); 
if (p == null) return Collections.emptyList(); 
return p.getFriends (); 


} 


public void makeFriends (String personl, String person2) { 
addFriend (personl, person2); 
addFriend (person2, personl]l); 


} 


public boolean areFriends (String personl, String person2) { 
Person p = friends.findByName (Person1) ; 
return p != null && p.getFriends().contains (person2); 


} 


private void addFriend(String person, String friend) { 
Person p = friends.findByName (person); 
if (p == null) p = new Person(person); 
p.addFriend (friend); 
friends.save(p); 


} 
完整 的 源 代码 可 在 FriendsCollection 和 Fri endshipsMongo 类 中 找到 , 这些 类 包含 在 仓 
库 https://bitbucket.org/vfarcic/tdd-java-ch02-example-junit.git 中 。 


将 Friendships 类 改 为 使 用 MongoDB 的 FriendshipsMongo 类 后 ， 下 面 看 一 种 使 用 模拟 对 
象 对 其 进行 测试 的 方式 。 





2.8.1 Mockito 


Mocekito 这 个 Java 框 架 让 你 能 够 轻松 创建 测试 替身 。 要 使 用 它 , 需要 在 Gradle 配 置 文件 中 添加 
如 下 依赖 项 : 


dependencies { 
testCompile group: 'org.mockito', name: 'mockito-all', version: '1.+' 


} 

Mockito 是 通过 JUnit 运 行 器 运行 的 ， 它 蔡 我 们 创建 所 有 必需 的 模拟 对 象 ， 并 将 其 注入 包含 测 
试 的 类 。 有 两 种 基本 方法 : 手工 实例 化 模拟 对 象 ， 并 通过 类 构造 函数 将 它们 作为 类 依赖 项 注入 ; 
使 用 一 系列 注解 。 下 面 的 示例 中 ， 我 们 将 演示 如 何 使 用 注解 注入 模拟 对 象 。 
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要 让 一 个 类 能 够 使 用 Mockito 注 解 ， 必 须 使 用 MockitoJUunitRunnetr 运 行 。 使 用 这 个 运行 器 
可 简化 工作 ， 因 为 你 只 需 给 要 创建 的 对 象 添加 注解 : 


QRunWith (MockitoJUnitRunner.class) 
public class FriendshipsTest { 


} 
测试 类 中 ， 需 要 使 用 einjectMocks 标 注 受 测 类 ， 以 告诉 Mockito 应 将 模拟 对 象 注入 哪个 类 ， 





@InjectMocks 
FriendshipsMongo friendships; 


接 下 来 , 需要 指定 要 将 这 个 类 ( FriendshipsMongo ) 中 的 哪些 方法 或 对 象 替换 为 模拟 对 象 : 


@Mock 
FriendsCollection friends; 


个 示例 中 ， 将 模拟 FriendshipsMongo 类 中 的 FriendsCollection。 


现在 ， 可 以 指定 friends 被 调用 时 应 返回 的 值 : 


Person joe = new Person("Joe"); 
doReturn(joe) .when (friends) .findByName ("Joe"); 
assertThat (friends.findByName ("Joe")).isEqualTo (joe); 


这 个 示例 中 ， 我 们 让 Mockito 在 friends .findByName ("joe") 被 调用 时 返回 对 象 joe; 然 
后 ， 使 用 assertThat 验 证 这 种 假设 是 正确 的 。 


下 面 再 来 做 一 个 测试 ， 这 个 测试 与 前 面 未 使 用 MongoDB 时 所 做 的 相同 








@Test 
public voidq joeHas5Friends() { 
List<String> expected = 
Arrays.asList ("Audrey", "Peter", "Michael", "Britney", "Paul"); 


Person joe = spy (new Person("Joe")); 


doReturn(joe) .when (friends) .findByName ("Joe"); 
doReturn (expected) .when (joe) .getFriends (); 


assertThat (friendships.getFriendsList ("Joe")) 
.hasSize(5) 
.containsOnly ("Audrey", "Peter", "Michael", "Britney", "Paul"); 


} 

这 个 小 小 的 测试 中 ， 发 生 的 事情 很 多 。 首 先 ， 我 们 将 joe 指 定 为 间谍 (spy )。Mockito 中 ， 除 
非 男 有 说 明 ， 否 则 间谍 是 使 用 真实 方法 的 真实 对 象 。 接 下 来 ,我们 让 Mockito 在 friengs. 
findByName ("joe") 被 调用 时 都 返回 对 象 joe， 并 在 joe.getFriends () 被 调用 时 返回 列表 
expected， 这 样 getFriendsList 被 调用 时 将 返回 列表 expected。 最 后 ， 我 们 使 用 断言 确认 
getFriendsList 确 实 返 回 了 姓名 列表 expected。 








A 
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完整 的 源 代码 可 在 FriendshipsMongoAssertJTest 类 中 找到 , 这 个 类 包含 在 仓库 https://bitbucket. 
org/vfarcic/tdd-java-ch02-example-junit.git 中 。 


本 书后 面 将 使 用 Mockito, 届时 你 将 有 机 会 更 深入 了 解 Mockito 和 模拟 技术 。 有 关 Mockito 的 更 
详细 信息 请 参阅 http://mockito.org/。 














2.8.2 EasyMock 





EasyMock 是 男 一 种 模拟 框架 , 它 与 Mockito 很 像 , 主要 差别 在 于 EasyMock 创 建 的 不 是 间谍 对 
而 是 模拟 对 象 ， 其 他 差别 都 属于 语法 方面 。 


下 面 看 一 个 EasyMock 示 例 ， 它 使 用 的 测试 用 例 与 Mockito 示 例 相同 : 


@RunWith (EasyMockRunner.class) 
public class FriendshipsTest { 
@TestSubject 
FriendshipsMongo friendships = new FriendshipsMongo(); 
@Mock (type = MockType.NICE) 
FriendsCollection friends; 


从 本 质 上 说 ，EasyMock 运 行 器 的 作用 与 Mockito 运 行 需 相同 。 


@TestSubject 
FriendshipsMongo friendships = new FriendshipsMongo(); 


象 





> 








@Mock (type = MockType.NICE) 
FriendsCollection friends; 


注解 erestsubject 类 似 于 Mockito 注 解 eInjectMocks， 而 注解 eMock 类 似 于 Mockito 注 解 
eMock， 也 标注 要 模拟 的 对 象 。 另 外 ，type 值 NICE 让 模拟 对 象 返回 空 (null )。 
下 面 比 较 前 面 使 用 Mockito 做 过 的 一 个 断言 : 
@Test 


public void mockingWorksAsExpected() { 
Person joe = new Person("Joe"); 








expect (friends.findByName ("Joe")).andReturn(joe); 
replay (friends); 
assertThat (friends.findByName ("Joe")).isEqualTo(joe); 


} 


除 细微 的 语法 差别 外 ，EasyMock 的 唯一 劣势 是 需要 添加 额外 的 指令 replay， 让 前 面 指 定 的 
期 望 生效 。 其 他 代码 几乎 完全 相同 。 我 们 指定 friends .findByName 应 返回 对 象 joe， 让 这 个 期 
望 生 效 ， 再 使 用 断言 检查 实际 结果 是 否 符合 预期 。 


我 们 使 用 Mockito 编 写 的 第 二 个 测试 方法 的 EasyMock 版 本 如 下 : 


@Test 
public void joeHasS5Friends() { 
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List<String> expected = 
Arrays.asList ("Audrey", "Peter", "Michael", "Britney", "Paul"); 
Person joe = createMock (Person.class); 


expect (friends.findByName ("Joe")).andReturn(joe); 
expect (joe.getFriends()).andReturn (expected); 
replay (friends); 

( 


replay (joe); 





assertThat (friendships.getFriendsList ("Joe")) 
.hasSize(5) 
.containsOnly ("Audrey", "Peter", "Michael", "Britney", 
"Paul"); 
} 


同样 ， 相 比 于 Mockito 版 本 几乎 没什么 不 同 ， 只 是 EasyMock 没 有 间谍 。 在 有 些 情况 下 ， 这 可 
能 是 重大 的 差别 。 


虽然 这 两 个 框架 很 像 ， 但 考虑 到 一 些 细节 ， 我 们 决定 在 本 书 中 始终 使 用 Mockito。 




















| 有 关 模 拟 框架 EasyMock 的 更 详细 信息 ， 请 参阅 http://easymock.org/。 


完整 的 源 代码 可 在 FriendshipsMongoEasyMockTest 类 中 找到 ， 这 个 类 包含 在 仓库 
https://bitbucket.org/vfarcic/tdd-java-ch02-example-junit.git 和 https://github.com/TechnologyConversations/ 
tdd-java-ch02-example-junit.git 中 。 


2.8.3 PowerMock 

前 面 介绍 的 两 个 框架 并 未 涵盖 所 有 类 型 的 方法 和 字段 。 

对 于 有 些 类 、 方 法 或 字段 ，Mockito 和 EasyMock 可 能 无 法 提供 模拟 支持 ， 这 取决 于 指定 的 限 
定 符 (如 static 或 final )。 这 种 情况 下 ， 可 使 用 PowerMock 扩 展 模 拟 框 架 ， 这 样 就 能 模拟 很 棘手 的 
对 象 。 然而 ,务必 要 慎 用 PowerMock， 因 为 如 果 必 须 使 用 它 提供 的 很 多 功能 ,通常 昭示 着 设计 很 
糟 粒 。 人 处 理 遗 留 代码 时 ，PowerMock 可 能 是 不 错 的 选择 ; 其 他 情况 下 ， 应 尽量 以 合理 的 方式 设计 
代码 ， 确 保 不 需要 使 用 PowerMock， 本 书后 面 将 介绍 。 

有 关 PowerMock 的 更 详细 信息 ， 请 参阅 https://code.google.com/p/powermock/。 



































2.9 用 户 珊 面 测试 


虽然 单元 测试 能 够 也 应 该 覆盖 应 用 程序 的 很 大 一 部 分 , 但 依然 需要 功能 测试 和 验收 测试 。 不 
同 于 单元 测试 , 它们 提供 更 高 层面 的 验证 , 通常 在 入 口 处 执行 , 且 严 重 依赖 用 户 界面 。 归 根 结 底 ， 
大 部 分 情况 下 ,我们 创建 的 应 用 程序 是 供 人 类 使 用 的 ,因此 确信 应 用 程序 行为 正常 至 关 重 要 。 要 
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获得 这 样 的 信心 ， 需 要 站 在 最 终 用 户 的 角度 对 应 用 程序 进行 测试 ， 确 保 其 行为 符合 预期 。 


下 面 概述 如 何 通 过 用 户 界面 进行 功能 测试 和 验收 测试 。 我 们 将 以 Web 为 例 ， 虽然 有 很 多 其 他 
类 型 的 用 户 界面 ， 如 桌面 应 用 程序 、 智 能 手机 界面 等 。 























2.9.1 Web 测试 框架 


本 章 前 面 测试 了 应 用 程序 类 和 数据 源 , 但 还 遗漏 了 一 项 , 那 就 是 最 常见 的 用 户 入 口 一 一 Web。 
大 多 数 企 业 应 用 ( 如 内 联网 和 公司 网 站 ) 都 是 通过 浏览 器 访问 的 ， 所 以 Web 测 试 意义 重大 ， 可 帮 
助 我 们 确信 其 行为 符合 预期 。 

另外 , 每 当 应 用 发 生变 化 时 ， 公 司 都 投入 大 量 时 间 执 行 漫长 而 繁重 的 手工 测试 。 这 是 巨大 的 
浪费 ， 因 为 通过 使 用 诸如 Selenium 和 Selenide 等 工具 ， 很 多 测试 都 可 自动 化 ， 在 无 人 值守 的 情况 
下 执行 。 














2.9.2 Selenium 

Selenium 是 一 款 出 色 的 Web 测 试 工具 ， 它 使 用 浏览 器 运行 验证 ， 并 支持 所 有 流行 的 浏览 器 ， 
如 Firefox 、Safari 和 Chrome。 它 还 支持 使 用 无 界面 浏览 器 (headless browser ) 测试 网 页 ， 这 样 可 
极 大 地 提高 速度 ， 同 时 减少 资源 消耗 。 

一 款 名 为 SeleniumIDE 的 插件 可 通过 记录 用 户 执 行 的 操作 创建 测试 , 但 当前 只 有 Firefox 支 持 。 
遗憾 的 是 ， 以 这 种 方式 生成 的 测试 虽然 能 快速 提供 结果 , 但 它们 通常 极其 脆弱 ， 最终 必然 带 来 问 
题 ,尤其 是 网 页 的 某 些 部 分 发 生变 化 时 。 有 鉴于 此 , 我 们 将 坚持 在 编写 测试 代码 时 始终 不 求助 于 
这 个 插件 。 

要 执行 Selenium ， 最 简单 的 方法 是 通过 JUnitRunner 运 行 。 所 有 Selenium 测 试 都 首先 初始 化 
用 于 同 浏览 器 通信 的 类 : 

(1) 我 们 首先 在 Gradle 配 置 文件 中 添加 依赖 项 : 


dependencies { 
testCompile 'org.seleniumhqg.selenium:selenium- java:2.45.0' 


} 
(2) 作为 示例 ， 我 们 将 创建 一 个 在 维基 百科 中 搜索 的 测试 ， 并 使 用 Firefox 驱 动 程序 : 
WebDriver driver = new FirefoxDriver(); 
WebDriver 是 一 个 接口 ， 可 使 用 Selenium 提 供 的 众多 驱动 程序 之 一 进行 实例 化 : 
(1) 使 用 如 下 指令 打开 一 个 URL: 


driver.get 
("http://en.wikipedia.org/wiki/Main Page"); 












































WebDriver 
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(2) 网 页 打开 后 ， 可 根据 名 称 找到 搜索 框 并 指定 要 搜索 的 内 容 : 


WebElement query = 
driver.findElement (By.name ("search")); 
query.sendKeys ("Test-driven development"); 


(3) 指定 要 搜索 的 内 容 后 ， 找 到 并 单 击 Go 按钮 : 


WebElement goButton = 
driver.findElement (By.name ("go")); 
goButton.click(); 


(4) 进入 目标 网 页 后 进行 验证 ， 这 里 是 为 了 确定 页 面 标 题 正 确 无 误 : 











assertThat (driver.getTitle(), 
startsWith("Test-driven development")); 


(5) 使 用 完 驱 动 程序 后 ， 应 将 其 关闭 : 














driver.quit (); 


就 这 么 简单 。 我 们 创建 了 一 个 很 小 但 很 有 用 的 测试 ， 它 验证 单个 用 例 。 对 于 Selenium， 虽然 
可 说 的 还 有 很 多 ,但 前 面 的 介绍 应 足以 让 你 认识 到 其 潜力 。 





有 关 Selenium 的 更 详细 信息 以 及 WebDriver 的 更 复杂 用 法 ,请 参阅 http://www. 
~ Seleniumhq.org/。 


完整 的 源 代码 可 在 SeleniumTest 类 中 找到 ， 这 个 类 包含 在 仓库 https://bitbucket.org/vfarcic/tdd- 
java-ch02-example-web.git 中 。 

Selenium 是 最 常用 的 Web 测 试 框架 , 但 它 很 低级 , 需要 做 大 量 微 调 。 如 果 有 一 个 更 高 级 的 库 ， 
能 够 实现 一 些 常见 模式 并 解决 反复 出 现 的 需求 ，Selenium 将 有 用 得 多 。Selenide 正 是 基于 这 种 理 
念 开 发 的 。 





























2.9.3 Selenide 


从 前 面 的 介绍 可 知 , Selenium 很 酷 , 让 我 们 能 够 核实 应 用 程序 是 否 表现 优异 。 但 有 些 情 况 下 ， 
配置 和 使 用 起 来 有 点 棘手 。Selenide 是 一 个 基于 Selenium 的 项 目 ， 提 供 了 优良 的 测试 编写 语法 ， 
提高 了 测试 的 可 读 性 。 它 将 WebDriver 和 配置 隐藏 ， 同 时 提供 了 极 大 的 定制 空间 : 


(1) 与 前 面 使 用 的 其 他 库 一 样 ， 首 先 需要 在 Gradle 配 置 文件 中 添加 依赖 项 : 





























dependencies { 
testCompile 'com.codeborne:selenide:2.17' 





} 
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(2) 下面 看 看 如 何 使 用 Selenide 编 写 前 面 的 Selenium 测 试 。 熟 悉 jQuery ( https://jquery.com/ ) 的 





读者 对 这 里 的 语法 可 能 不 会 感到 陌生 : 


public class SelenideTest { 
@Test 
public voidq wikipediaSearchFeature() throws 
InterruptedException { 
// 打开 维基 百科 页 面 


open("http://en.wikipedia.org/wiki/Main Page"); 


// 搜索 TDD 
$s(By.name("search")).setValue("Test-driven" + 
"development "); 


// 单 击 搜索 按钮 
$s(By.name ("go")) .click(); 


// 检查 结果 
assertThat (title(), startsWith("Test-driven" + 
"development")); 


} 


这 种 测试 编写 方式 的 表达 力 更 强 ， 不 但 语法 更 流畅 ， 这 些 代 码 后 面 也 自动 执行 了 一 些 操 














作 一 一 使 用 Selenium 时 需要 编写 额外 的 代码 行 执行 。 例 如 ， 单 击 操作 将 等 到 目 
行 , 且 仅 在 等 待 时 间 超过 指定 时 间 时 , 这 个 操作 才 会 失败 。 而 Selenium 中 ， 如 及 
单 击 操作 将 立即 失败 。 当 前 , 很 多 元 素 都 是 通过 JavaScript 动 态 加 载 的 , 不 能 指 









































标 元 素 可 用 后 再 执 
目标 元 素 不 可 用 ， 
望 所 有 元 素 都 会 立 


即 出 现 。 因 此 ，Selenide 提 供 的 这 项 功能 很 有 用 ， 让 我 们 无 需 反 复 编 写 样板 式 代 码 。Selenide 还 带 
来 了 众多 其 他 好 处 。 鉴 于 Selenide 相 比 于 Selenium 存 在 这 些 优 点 ,本 书 将 始终 使 用 它 进 行 Web 测 试 。 





另外 ， 后 面 有 一 章 专 门 介绍 如 何 使 用 这 个 框架 进行 Web 测 试 。 有 关 如 何在 测试 中 使 用 Web 驱 动 程 





序 的 更 详细 信息 ， 请 参阅 http://selenide.org/。 














LA 











不 管 测试 是 使 用 哪个 框架 编写 的 , 效果 都 相同 : 测试 运行 时 , 将 出 现 一 个 Firefox 浏 览 需 窗 口 ， 


并 依次 执行 测试 指定 的 步骤 。 除 非 使 用 的 是 无 界面 浏览 器 ,否则 你 将 看 到 整个 测试 过 程 。 如 果 发 
生 错 误 ， 可 使 用 故障 跟踪 ( failure trace )。 男 外 ， 你 还 可 随时 截取 浏览 如 屏幕 快照 ， 例 如 ， 一 种 








常见 的 做 法 是 将 出 现 故 障 时 的 情形 记录 下 来 。 


完整 的 源 代码 可 在 SelenideTest 类 中 找到 ， 这 个 类 包含 在 仓库 https://bitbucket.org/vfarcic/tdd- 


java-ch02-example-web.git 中 。 
对 Web 测 试 框 架 有 基本 认识 后 ， 下 面 看 看 BDD。 
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2.10 ”行为 驱动 开发 


行为 驱动 开发 ( BDD ) 是 一 种 敏捷 过 程 ， 旨 在 整个 项 目 开 发 过 程 中 都 专注 于 相关 方 的 利益 。 
BDD 基 于 这 样 的 前 提 ， 即 需求 必须 以 所 有 人 【业务 代表 、 分 析 师 、 开 发 人 员 、 测 试 人 员 、 项 目 经 
理 等 ) 都 能 看 懂 的 方式 编写 。 这 里 的 关键 是 提供 一 组 人 人 都 能 理解 并 使 用 的 独特 工件 一 一 一 系列 
用 户 故 事 。 这些 故 事由 整个 团队 编写 , 并 被 用 作 需 求 和 可 执行 的 测试 用 例 。 这 是 一 种 TDD 实 施 方 
式 , 但 具有 单元 测试 无 法 比拟 的 清晰 度 ; 这 还 是 一 种 描述 和 测试 功能 的 方式 ， 其 中 的 测试 几乎 完 
全 是 使 用 自然 语言 编写 的 ， 但 既是 可 运行 的 ， 又 是 可 重复 的 。 

故事 由 场景 组 成 ， 而 每 个 场景 都 是 使 用 自然 语言 编写 的 ， 表示 一 个 简洁 的 用 例 ， 由 不 同步 又 
组 成 。 步 又 按 顺 序 排列 ， 定 义 了 场景 的 前 置 条 件 、 事 件 和 结果 。 每 个 步 又 都 以 单词 Given、When 
或 Then 打 头 ， 其 中 Given 用 于 指定 前 置 条 件 ，When 用 于 指定 操作 ， 而 Then 用 于 执行 验证 。 

这 里 只 是 简要 的 介绍 ， 本 书后 面 有 一 章 (第 7 章 ) 专门 介绍 这 个 主题 。 下 面 介绍 JBehave 和 
众多 故事 编写 和 执行 框架 中 的 两 个 。 























































































































Cucumber 





2.10.1 JBehave 


JBehave 是 一 个 Java BDD 框 架 ， 用 于 编写 可 执行 和 自动 化 的 验收 测试 。 故 事 中 的 步 又 被 关联 
到 Java 代 码 ， 这 是 通过 使 用 这 个 框架 提供 的 注解 实现 的 : 


(1) 首先 ， 在 Gradle 配 置 文件 中 添加 JBehave 依 赖 项 : 


























dependencies { 
testCompile 'org.jbehave:jbehave-core:3.9.5"' 
(2) 下 面 看 儿 个 步骤 : 


@Given("I go to Wikipedia homepage") 

public void goToWikiPage() { 
open("http://en.wikipedia.org/wiki/Main Page"); 

} 


(3) 这 是 一 个 Given 步 又 ,表示 要 成 功 执行 后 续 操作 必须 满足 的 一 个 前 置 条 件 ， 此 处 指 打开 一 
个 维基 百科 网 页 。 指 定 前 置 条 件 后 ， 定 义 一 些 操作 : 























@When("I enter the value S$value on a field named " + 
"SfieldName") 
public void enterValueOnFieldByName (String value, 
String fieldName){ 
$s (By.name (fieldName)) .setValue (value); 
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@When("I click the button $buttonName") 
public void clickButonByName (String buttonName)t{ 
$s (By.name (buttonName)) .click(); 


} 


(4) 正如 你 看 到 的 ， 操 作 是 使 用 注解 ewhen 定 义 的。 在 这 里 ,我们 使 用 这 些 步 骤 设 置 一 个 文 
本 框 的 值 并 单 击 特 定 按钮 。 操 作 执 行 完 毕 后 进行 验证 ， 注 意 ， 引 入 参数 可 让 步骤 更 灵活 : 























@Then("the page title contains $title") 

public void pageTitleIs (String title) { 
assertThat (title(), containsString (title)); 

} 


验证 是 使 用 注解 eThen 声 明 的 。 这 个 示例 中 ， 我 们 验证 页 面 标题 符合 预期 。 

这 些 步骤 可 在 websteps 类 中 找到 ， 这 个 类 包含 在 仓库 https://bitbucket.org/vfarcic/tdd-java- 
ch02-example-web.git 中 。 

定义 并 使 用 步 又。 下 面 的 故事 将 这 些 步 又 组 合 在 一 起 ， 旨 在 验证 期 望 的 行为 : 

Scenario: TDD search on wikipedia 


它 首先 指定 了 场景 名 称 。 场 景 名 的 唯一 目的 是 提供 足够 的 信息 , 应 尽 可 能 简洁 ， 同 时 能 明确 
标识 用 例 。 


















































Given I go to Wikipedia homepage 

When I enter the value Test-driven development on a field named search 
When I click the button go 

Then the page title contains Test-driven development 


正如 你 看 到 的 , 这 里 使 用 了 前 面 定义 的 步骤 文本 。 依 次 执行 与 这 些 步 骤 相 关联 的 代码 ,如果 
有 代码 出 现 问题 ， 将 终止 执行 ， 而 场景 本 身 将 被 视 为 失败 的 。 


虽然 这 里 是 在 故事 前 定义 的 步骤 , 但 也 可 按 相 反 的 顺序 做 一 一 先 定义 故事 再 定义 步骤 。 这 种 
情况 下 ,场景 将 处 于 悬 置 ( pending ) 状态 ， 这 意味 着 缺失 必要 的 步 又。 

这 个 故事 可 在 文件 wikipedqiasearch.story 中 找到 ， 这 个 文件 包含 在 仓库 https:/bitbucket. 
org/vfarcic/tdd-java-ch02-example-web.git 中 。 

为 运行 这 个 故事 ， 执 行 如 下 命令 : 

$> gradle testJBehave 


这 个 故事 运行 时 ,你 将 在 浏览 咒 中 看 到 执行 的 操作 。 运 行 完 毕 后 ， 生 成 一 个 包含 执行 结果 的 
报告 ， 它 存储 在 目录 bui1qd/reports/jbehnave 中 。 
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bdd/jbehave/stories /wikipediaSearch.story 


Scenario: Wikipedia search 


Given | go to Wikipedia homepage 

When | enter the value Test-driven development on a field named search 
When | click the button go 

Then the page title contains Test-driven development 














hl 





有 执行 报告 


为 简洁 起 见 ， 这 里 删除 了 运行 JBehave 故 事 的 build.gradle 代 码 。 完 整 的 源 代码 可 在 仓库 
https://bitbucket.org/vfarcic/tdd-java-ch02-example-web.git 中 找到 。 


JBehave 故 





| 有 关 JBehave 的 更 详细 信息 及 其 带 来 的 好 处 ， 请 参阅 http://jbehave.org/。 


2.10.2 Cucumber 


Cucumber 最 初 是 一 个 Ruby BDD 框 架 , 但 现在 支持 包括 Java 在 内 的 多 种 语言 ， 它 提供 的 功能 
与 JBehave 很 像 。 


下 面 看 看 如 何 使 用 Cucumber 编 写 前 面 的 示例 。 


与 之 前 使 用 的 其 他 框架 一 样 , 要 使 用 Cucumber, 也 必须 在 配置 文件 buila.gradle 中 添加 相 
应 的 依赖 项 : 

















dependencies { 


testCompile 'info.cukes:cucumber-java:1.2.2' 
testCompile 'info.cukes:cucumber-junit:1.2.2' 


二 
使 用 Cucumber 创 建 前 面 使 用 JBehave 时 创建 的 步 又， 





@Given("^I go to Wikipedia homepages") 
public void goTowikipPpage() { 

open ("http://en.wikipedia.org/wiki/Main Page"); 
} 


@When("^I enter the value (.*) on a field named (.*)$") 
public void enterValueOnFieldByName (String value, 
String fieldName){ 
$s(By.name (fieldName)) .setValue (value); 


} 


@When("^I click the button (.*)$") 
public void clickButonByName (String buttonName) { 


EE| 
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$s (By.name (buttonName)) .click(); 
} 
@Then("^the page title contains (.*)$") 


public void pageTitleIs(String title) { 
assertThat (title(), containsSstring(title)); 


J 

这 两 个 框架 唯一 显著 的 差别 在 于 Cucumber 定 义 步骤 文本 的 方式 , 它 使 用 正则 表达 式 匹 配 变 
类 型 ， 而 不 像 JBehave 那 样 根据 方法 签名 推断 。 

这 些 步骤 的 代码 可 在 websteps 类 中 找到 ， 而 这 个 类 包含 在 仓库 https://bitbucket.org/ 
vfarcic/tdd-java-ch02-example-web.git 中 。 





二 











a 




















下 面 看 看 使 用 Cucumber 语 法 编写 的 故事 : 


Feature: Wikipedia Search 


Scenario: TDD search on wikipedia 
Given I go to Wikipedia homepage 
When I enter the value Test-driven development on a field named search 
When I click the button go 
Then the page title contains Test-driven development 





儿 乎 没什么 不 同 。 这 个 故事 可 在 文件 wikipediaSearch.feature 中 找到 , 这 个 文件 包含 在 
仓库 https://bitbucket.org/vfarcic/tdd-java-ch02-example-web.git 中 。 








你 可 能 猜 到 了 ， 要 运行 Cucumber 故 事 ， 只 需 执 行 如 下 Gradle 任 务 : 


$> gradle testCucumber 


结果 报告 存储 在 目录 bui1l94/reports/cucumber-report 中 。 上 述 故 事 的 报告 如 下 : 





v Feature: Wikipedia Search 
vv Scenario: TDD search on wikipedia 
Given I go to Wikipedia homepage 
When Ienter the value Test-driven development on a field named search 
When I click the button go 
Then the page title contains Test-driven development 











Cucumber 故 事 的 执行 报告 


完整 的 代码 示例 可 在 仓库 https://bitbucket.org/vfarcic/tdd-java-ch02-example-web.git 中 找到 。 


| 有 关 Cucumber 支 持 的 语言 清单 和 其 他 细节 ， 请 参阅 https://cukes.info/。 





鉴于 JBehave 和 和 Cucumber 提供 的 功能 类 似 , 我 们 决定 在 本 书后 面 都 使 用 JBehave。 本 书后 面 有 
一 章 专 门 介绍 BDD 和 JBehave。 
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2.11 小 结 

本 章 暂时 放下 TDD , 转 而 介绍 了 本 书后 面 演示 代码 时 需要 用 到 的 众多 工具 和 框架 一 一 从 版 本 
控制 、 虚 拟 机 、 构 建 工具 和 IDE 到 当前 常用 的 测试 框架 。 

我 们 是 开源 运动 的 坚定 支持 者 ， 本 着 这 种 精神 ， 对 于 每 类 工具 和 框架 ， 我们 都 尽力 选择 免 | 
费 的 。 


准备 好 需要 的 所 有 工具 后 ， 下 面 更 深入 地 探索 TDD 一 一 从 TDD 的 中 流 碟 柱 “ 红 灯 -- 绿 灯 一 重 
构 ” 着 手 。 
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红 灯 -- 绿 灯 - 重 构 一 一 从 失败 
到 成 功 再 到 完美 








“ 光 知 道 还 不 够 ， 还 必须 付 诸 应 用 ; 光 有 决心 还 不 够 ， 还 必须 行动 .” 


一 李小龙 
“ 红 灯 - 绿 灯 - 重 构 ” 流 程 是 TDD 的 基石 ， 这 个 过 程 就 像 玩 乒乓 球 ， 以 极 快 的 速度 在 测试 和 实 
现代 码 之 间 切 换 。 期 间 将 失败 ， 然 后 成 功 ， 最 后 改进 。 


本 章 将 开发 一 个 “ 井 字 游戏 ”"， 期 间 每 次 只 考虑 一 个 需求 。 我 们 首先 编写 一 个 测试 ， 看 看 它 
是 否 未 通过 ; 然后 编写 实现 这 个 测试 的 代码 ,运行 所 有 测试 并 看 看 它们 是 否 都 通过 ; 最 后 , 通过 
重 构 改进 代码 。 这 个 过 程 将 重复 多 次 ， 直 到 成 功 实 现 所 有 需求 。 


我 们 将 首先 使 用 Gradle 和 和 JUnit 搭建 环境 ， 然 后 更 深入 地 介绍 “ 红 灯 - 绿 灯 - 重 构 ” 过 程 。 搭 建 
好 环境 并 做 好 理论 上 的 准备 工作 后 ， 我 们 将 确定 这 个 应 用 程序 的 粗略 需求 。 


一 切 都 准备 就 绪 后 , 投入 开发 工作 一 一 每 次 解决 一 个 需求 。 完 成 开发 工作 后 ,检查 代码 覆盖 
率 ， 并 据 此 判断 结果 可 以 接受 还 是 需要 添加 更 多 测试 。 


本 章 涵盖 如 下 主题 : 


口 使 用 Gradle: 和 JUnit 搭 建 环境 ; 
口 “ 红 灯 - 绿 灯 - 重 构 ” 过 程 ; 
口 “ 井 字 游 戏 ”的 需求 ; 

口 开发 “ 井 字 游戏 ”; 

口 代码 覆盖 率 ; 

口 更 多 练习 。 
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3.1 使 用 Gradle 和 JUnit 搭建 环境 


你 很 可 能 熟悉 如 何 创建 Java 项 目 ， 但 可 能 没有 使 用 过 IntelliJ IDEA ， 或 者 使 用 的 构建 工具 是 
Maven 而 不 是 Gradle。 为 确保 你 能 按 本 书 介 绍 的 方法 做 ， 下 面 简 要 说 明 如 何 创建 项 目 。 


























在 IntelliJ IDEA 中 创建 Gradle/Java 项 目 


本 书 的 主要 目标 是 介绍 TDD, 因此 不 会 详细 介绍 Gradle 和 IntelliJ IDEA。Gradle 和 Intellij IDEA 
都 只 是 手段 ， 本 书 的 所 有 练习 都 可 使 用 其 他 IDE 和 构建 工具 完成 , 例如 ,可 使 用 Maven 和 Eclipse。 
从 很 大 程度 上 说 ， 完 全 按 本 书 说 的 做 可 能 更 容易 ， 但 如 何 选择 由 你 决定 。 


要 在 Intellij IDEA 中 新 建 一 个 Gradle 项 目 ， 可 按 下 面 的 步骤 做 : 


(1) 启动 IntelliJj IDEA， 单 击 Create New Project 亲 从 左边 的 列表 中 选择 Gradle， 再 单 击 Next 
按钮 。 

(2) 如 果 使 用 的 是 IDEA 14 或 更 高 版 本 ， 将 要 求 指定 工件 (Artifact ) ID 。 输 入 tdd-java-ch03- 
tic-tac-toe 并 单 击 Next 按 钮 两 次 ， 再 将 项 目 名 指定 为 tdd-java-ch03-tic-tac-toe， 然 后 单 击 Finish 
按钮 。 

































































New Project 


口 Use auto-import 

DD Create directories for empty content roots automatically 

© Use default gradle wrapper (recommended) 

©O Use customizable gradle wrapper © Gmdle wrapper customization in script, works with Gradle 1.7 or later 

OO Use local gradle distribution 

Gradle home: [ | 
Gradle JVM: | [31.8 (javaversion "1.8.0_45", path: /usr/lib/jvm/java-8-oracle) 图 











| Brevious | | Next | | Cancel | | Help | 


从 New Project 窗 格 可 知 ，IDEA 已 经 创建 了 文件 bui1lg.gradle。 打 开 这 个 文件 ， 可 以 发 现 
其 中 已 经 包含 JUnit 依 赖 项 。 本 章 只 使 用 这 个 框架 ， 因 此 不 需要 再 添加 其 他 配置 。 默 认 情 况 下 ， 
builgd.gradle 将 源 代码 兼容 性 设置 指定 为 Java 1.5, 但 可 将 其 修改 为 任何 你 喜欢 的 版 本 。 本 章 示 
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从 失败 到 成 功 再 到 完美 





例 不 会 使 用 Java 1.5 之 后 推出 的 新 功能 ， 


个 练习 。 





这 个 项 目的 bui1lqd.gradle 文 件 应 类 似 于 下 面 这 样 : 


apply plugin: 'Jjava' 

version = '1.0' 

repositories { 
mavenCentral(). 


} 


dependencies { 
testCompile group: 


下 本 


name: 'Jjunit'， 


version: '4.11' 


} 


现在 , 余下 的 唯一 工作 是 创建 测试 包 和 实现 包 。 在 Project 徐 格 中 右 击 打开 上 下 文 菜单 ,选择 
New > Directory, 输入 src/tes 























日 这 并 不 意味 着 不 能 使 用 更 高 的 版 本 ( 如 JDK 8 ) 完成 这 





t/java/com/packtpublishing/tddjava/ch03tictactoe 


并 单 击 OK 按钮 ， 以 创建 测试 包 。 重 复 上 述 步 又 ， 但 输入 目录 src/main/java/comy 


packtpublishing/tddjava/ch03tictactoe, 以 创建 实现 包 。 


最 后 ,我 们 需要 创建 测试 类 和 实现 类 。 为 此 ， 在 目录 src/test/java 下 的 com.packt- 
publishing.tddjava.ch03tictactoe 包 中 创建 TicTacToeSpec 类 ， 它 将 包含 所 有 测试 。 重 
复 上 述 过 程 ， 在 目录 src/main/java 中 创建 TicTacToe 类 。 


此 时 ,项 目 结构 应 类 似 于 下 图 。 











Project -| 全 不 | 桨 "I" 








Catdd-java-ch03-tic-tac-toe (~/|deaProje 


口 .gradle 
户 .idea 
口 build 
户 src 
记 main 
口 java 
口 com 
户 packtpublishing 
口 tddjava 
DD ch03tictactoe 
[BB TicTacToe.java 
Dtest 
口 java 
口 com 
户 packtpublishing 
口 tddjava 
DD cho3tictactoe 


BTicTacToeSpec.| 


© .gitignore 

S build.gradle 

3 settings.gradle 

引 上 dd-java-ch03-tic-tac-toe,iml 
吃 External Libraries 
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可 在 Git 仓 库 tad-java-ch03-tic-tac-toe 的 00-setup 分 支 (https://bitbucket.org/vfarcic/ 
tdd-java-ch03-tic-tac-toe/branch/00-setup ) 中 找到 源 代码 。 





务必 将 测试 和 实现 代码 分 开 。 
这 样 做 的 好 处 是 : 可 避免 不 小 心 将 测试 与 产品 二 进 制 文件 一 起 打包 ; 很 多 构 
建 工具 都 假定 测试 位 于 特定 的 源 代码 目录 。 
一 种 常见 的 做 法 是 ， 确 保 至 少 有 两 个 源 代 码 目录 : 将 实现 代码 放 在 目录 
Q src/main/java 中 ,并 将 测试 代码 放 在 目录 src/test/java 中 。 较 大 的 项 目 中 ， 
源 代码 目录 可 能 更 多 ， 但 依然 必须 将 实现 和 测试 分 开 。 
诸如 Maven 和 Gradle 等 构建 工具 要 求 将 源 代码 目录 分 开 ， 还 要 求 遵 循 特 定 的 
命名 约定 。 


准备 工作 至 此 完成 ， 可 以 开始 开发 “ 井 字 游戏 ”了 。 将 JUnit 用 作 测 试 框架 ， 并 使 用 Gradle 执 
行 编译 、 依 赖 、 测 试 和 其 他 任务 。 第 1 章 简要 介绍 了 “ 红 灯 - 绿 灯 - 重 构 ” 过 程 ， 它 是 TDD 的 中 流 
研 柱 ， 而 本 章 练习 的 主要 目标 就 是 熟悉 这 个 过 程 。 因 此 ,着手 开 发 “ 井 字 游 戏 ” 前 ， 需 要 对 整个 
过 程 进 行 更 详细 的 介绍 。 
































3.2 “ 红 灯 - 绿 灯 - 重 构 ” 过 程 
“ 红 灯 - 绿 灯 - 重 构 ” 过 程 是 TDD 最 重要 的 组 成 部 分 ， 是 最 主要 的 支柱 。 如 果 没有 它 ，TDD 的 
其 他 方面 根本 行 不 通 。 
这 个 名 称 源 自 代码 在 周期 内 的 状态 : 处 于 红 灯 状 态 时 ， 代 码 不 管用 ; 处 于 绿灯 状态 时 , 一切 
都 像 预 期 的 那样 工作 , 但 并 不 一 定 是 最 佳 的 ; 到 了 重 构 阶 段 ， 我 们 知道 测试 很 好 地 履 盖 了 各 项 功 
能 ， 可 以 充满 信心 地 去 修改 它 ， 让 它 变 得 更 好 。 





























3.2.1 编写 一 个 测试 

每 次 添加 新 功能 时 都 首先 编写 一 个 测试 , 这 骨 在 编写 代码 前 专注 于 需求 和 代码 设计 。 测试 是 
可 执行 的 文档 ， 以 后 能 够 帮助 理解 代码 目的 及 其 背后 的 意图 。 

当前 , 我 们 处 于 红 灯 状 态 ， 因 为 测试 执行 时 以 失败 告终 ， 即 测试 对 代码 的 期 望 和 代码 实际 的 
功能 之 间 存 在 差距 。 更 具体 地 说 , 没有 代码 满足 最 后 一 个 测试 的 期 望 ， 因 为 我 们 还 没有 编写 这 样 
的 代码 。 在 这 个 阶段 ， 可 能 所 有 测试 都 通过 了 ， 但 这 昭示 着 存在 问题 。 























3.2.2 ”运行 所 有 测试 并 确认 最 后 一 个 未 通过 
确认 最 后 一 个 测试 未 通过 后 , 就 能 断定 它 不 会 在 没有 引入 新 代码 的 情况 下 错误 通过 。 如 果 这 
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个 测试 通过 了 ,就 意味 着 要 么 相关 功能 早 就 存在 ,要么 测试 本 身 存在 误 报 问题 。 如 果 测 试 无论 怎 
样 实现 都 能 通过 ， 就 意味 着 它 毫 无 价值 ， 应 该 删除 。 


最 后 一 个 测试 不 仅 必须 未 通过 ， 还 必须 是 预期 原因 导致 的 。 


在 这 个 阶段 ， 我 们 依然 处 于 红 灯 状 态 : 运行 测试 ， 但 最 后 一 个 未 通过 。 


























3.2.3 ”编写 实现 代码 


这 个 阶段 的 目标 是 编写 代码 使 最 后 一 个 测试 通过 。 不 要 试图 让 代码 完美 无 缺 , 也 不 要 为 编写 
花 过 多 时 间 。 即 便 编写 的 不 好 或 者 不 是 最 后 的 ， 也 没有 关系 ， 后面 还 有 改进 的 机 会 。 我 们 的 真实 
意图 是 打造 一 个 由 测试 构成 的 安全 网 , 并 确认 这 些 测试 都 能 通过 。 不 要 试图 引入 最 后 一 个 测试 未 
描述 的 功能 。 要 想 引 入 新 功能 ， 必 须 回 到 第 一 步 ， 先 编写 新 测试 。 然而, 仅 当 所 有 既 有 测试 都 通 
过 后 ， 我 们 才能 这 么 做 。 


在 这 个 阶段 , 我 们 依然 处 于 红 灯 状 态 。 虽然 已 编写 的 代码 可 能 让 所 有 测试 都 通过 , 但 这 种 假 
设 还 未 得 到 证 实 。 



















































































3.2.4 运行 所 有 测试 


应 运行 所 有 测试 ， 而 不 是 只 运行 最 后 编写 的 那个 测试 , 这 至 关 重 要 。 你 刚 编写 的 代码 可 能 让 
最 后 一 个 测试 得 以 通过 , 但 同时 破坏 了 其 他 功能 。 通 过 运行 所 有 测试 ,不仅 可 确认 最 后 一 个 测试 
的 实现 是 正确 的 ， 还 可 确认 它 没 有 破坏 整个 应 用 程序 的 完整 性 。 如 果 整 个 测试 集 执行 速度 缓慢 ， 
就 昭示 着 测试 编写 得 不 好 或 者 代码 耦合 度 太 高 。 耦 合 度 大 高 将 导致 难以 隔离 外 部 依赖 ,进而 增加 
执行 测试 所 需 的 时 间 。 


在 这 个 阶段 ， 我 们 处 于 绿灯 状态 : 所 有 测试 都 通过 ， 且 应 用 程序 的 行为 符合 预期 。 

































































3.2.5 ” 重 构 


前 面 所 有 步骤 都 是 必 不 可 少 的 ,但 这 一 步 是 可 选 的 。 虽 然 很 少 在 每 个 周期 结束 后 都 进行 重 构 ， 
但 迟早 需要 甚至 必须 这 样 做 。 并 非 每 个 测试 的 实现 都 需要 重 构 ; 没有 明确 的 规定 说 什么 时 候 该 重 
构 、 什 么 时 候 不 用 重 构 。 一 旦 认为 可 以 更 佳 或 更 优 的 方式 重 写 代 码 ， 那 就 是 重 构 的 最 佳 时 机 。 

什么 样 的 代码 需要 重 构 呢 ?” 这 个 问题 不 好 回答 ， 因 为 重 构 的 原因 有 很 多 : 代码 难以 理解 、 代 
码 位 置 不 合理 、 代 码 重 复 、 名 称 没有 清晰 逆 述 意图 、 方 法 太 长 、 类 的 功能 太 多 等 一 一 这 个 清单 可 
不 断 列 下 去 。 不 管 原因 是 什么 ， 最 重要 的 规则 是 重 构 不 能 改变 任何 既 有 功能 。 
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3.2.6 重复 


所 有 步 又 都 完成 后 ( 其 中 重 构 是 可 选 的 )， 再 重复 它们 。 乍 一 看 ， 整 个 过 程 好 像 太 长 、 太 复 
杂 , 但 并 不 是 这 样 的 。 经 验 丰富 的 TDD 践 行者 编写 1~10 行 代码 后 就 切换 到 下 一 步 ,， 因此 整个 周期 
的 持续 时 间 为 几 秒 ~ 几 分 钟 。 如 果 更 长 ， 就 说 明 测 试 的 范围 太 大 ， 应 将 其 分 成 多 个 更 小 的 测试 。 














一 定 要 快速 前 进 ， 快 速 失 败 并 更 正 ， 然 后 再 重复 。 


深入 了 解 “ 红 灯 - 绿 灯 - 重 构 " 过 程 后 , 下 面 确定 我 们 要 使 用 这 种 过 程 开发 的 应 用 程序 的 需求 。 


3.3 “ 井 子 游戏 ”的 需求 
“ 井 字 游戏 ”是 儿童 常 玩 的 一 种 游戏 ， 规 则 非常 简单 。 


“并 字 游戏 ”是 两 个 人 使 用 纸 和 铅笔 玩 的 一 种 游戏 ， 双 方 轮流 在 一 个 3 x3 
的 网 格 中 画 X 和 0O， 最 先 在 水 平 、 垂 直 或 对 角 线 上 将 自己 的 3 个 标记 连 起 来 的 玩 


有 关 这 款 游 戏 的 更 详细 信息 ， 请 参阅 维基 百科 (http:/en.wikipedia.org/ 


wiki/Tic-tac-toe )。 


更 详细 的 需求 将 在 后 面 介 绍 。 




















这 个 练习 中 ,你 将 根据 需求 编写 测试 ， 再 编写 满足 测试 期 望 的 代码 。 最 后 ， 如 果 必 要 ,将 对 
代码 进行 重 构 。 你 将 重复 这 个 过 程 ， 针 对 同一 需求 编写 多 个 测试 。 对 针对 当前 需求 编写 的 测试 和 














实现 代码 满意 后 ， 进 入 下 一 个 需求 ， 直 到 处 理 完 所 有 需求 。 





现实 世界 中 ,你 并 不 会 预先 制定 如 此 详细 的 需求 , 而 是 直接 编写 同时 用 作 需 求 和 验证 的 测试 。 





然而 ,熟练 掌握 TDD 前 ， 我 们 必须 将 需求 和 测试 分 开 定义 。 











虽然 后 面 提供 了 所 有 测试 和 实现 ,但 每 次 只 阅读 一 个 需求 ,再 自己 尝试 编写 测试 和 实现 代码 。 








完成 后 再 将 解决 方案 与 本 书 提供 的 解决 方案 进行 比较 , 然后 进入 下 一 个 需求 。 不 存在 有 | 








个 解决 方案 的 情况 一 一 你 的 解决 方案 可 能 比 这 里 提供 的 更 好 。 


3.4 开发 “ 井 字 游戏 ” 
准备 好 开始 编写 代码 了 吗 ? 下 面 看 第 一 个 需求 。 
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3.4.1 需求 1 
我 们 应 该 首先 定义 边界 ， 以 及 将 棋子 放 在 哪些 地 方 非法 。 








| 可 将 棋子 放 在 3x3 棋 盘 上 任何 没有 棋子 的 地 方 。 


可 将 这 个 需求 分 成 三 个 测试 : 


口 如 果 棋 子 放 在 超出 了 X 轴 边界 的 地 方 ， 就 引发 RuntimeException 
口 如 果 棋 子 放 在 超出 了 Y 轴 边界 的 地 方 ， 就 引发 RuntimeException 
口 如 果 棋 子 放 在 已 经 有 棋子 的 地 方 ， 就 引发 RuntimeException 异 常 。 


正如 你 看 到 的 , 与 第 一 个 需求 相关 的 测试 都 验证 输入 参数 。 至 于 这 些 棋子 该 如 何 处 理 呢 ? 这 
个 需求 什么 都 没 说 。 
编写 第 一 个 测试 前 ， 先 简单 说 说 如 何 使 用 JUnit 测 试 异常 。 

JUnit 4.7 引 入 了 一 项 名 为 规则 (Rule ) 的 功能 ， 使 用 它 可 以 做 很 多 不 同 的 事情 ( 更 详细 的 信 
息 请 参阅 https://github.com/junit-teanmyjunit/wiki/Rules ), 但 在 这 里 我 们 感 兴趣 的 是 规则 Expected- 


Exception: 


» 


已 A 
天 吊 
已 A 
天 吊 















































public class FooTest { 
@Rule 
public ExpectedException exception = 
ExpectedException.none(); 


@Test 

public void whenDoFooThenThrowRuntimeException() { 
Foo foo = new Foo(); 
exception.expect (RuntimeException.class); 
foo.doFoo(); 

} 


这 个 示例 中 ， 我 们 指定 ExpectedException 是 一 条 规则 ; 接 下 来 ， 在 测试 doFooThrows- 
RuntimeException 中 , 我 们 指出 Foo 类 被 实例 化 后 ,期望 引发 Runt imeException 异 常 。 如果 
这 种 异常 是 在 实例 化 前 引发 的 ， 这 个 测试 将 失败 ; 反之， 测试 将 成 功 。 

eBefore 可 用 来 标注 要 在 每 个 测试 前 运行 的 方法 ， 这 是 一 项 很 有 用 的 功能 。 例 如 ， 你 可 使 用 
它 实例 化 测试 中 使 用 的 类 ， 或 者 指定 要 在 每 个 测试 前 执行 的 其 他 操作 









































Private Foo foo; 


@Before 
public final void before() { 
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foo = new Foo(); 


} 
这 个 示例 中 ， 在 每 个 测试 前 都 将 实例 化 Foo 类 ， 这 样 就 不 用 在 每 个 测试 方法 中 重复 编写 实例 


化 Foo 的 代码 了 o 


\ 一 人 一 


每 个 测试 方法 都 必须 用 erest 标 注 , 让 JunitRunner 知 道 哪些 方法 是 测试 。 测 试 以 随机 顺序 

















运行 ， 因 此 务必 确保 每 个 测试 都 是 自给 自足 的 ， 不 依赖 于 其 他 测试 设置 的 状态 : 


@Test 

public void whenSomethingThenResultIsSomethingElse() { 
// 这 是 一 个 测试 方法 。 

} 


有 了 这 些 知识 后 ,你 应 该 能 够 编写 第 一 个 测试 , 并 接着 编写 其 实现 。 完 成 后 将 其 与 后 面 提供 























的 解决 方案 进行 比较 。 


给 测试 方法 指定 描述 性 名 称 
这 样 做 的 好 处 之 一 是 有 助 于 理解 测试 的 目标 。 
使 用 描述 测试 的 方法 名 很 有 益 , 可 帮助 掌握 有 些 测试 失败 的 原因 以 及 在 什么 
情况 下 增加 测试 可 提高 代码 覆盖 率 。 在 测试 方法 名 中 , 应 明确 指出 测试 前 设置 的 
AN 条 件 、 执 行 的 操作 以 及 期 望 的 结果 。 


Q 给 测试 方法 命名 的 方式 很 多 ， 我 喜欢 采用 BDD 场 景 使 用 的 given/when/ 


提示 


then 语 法 给 它们 命名 ， 其 中 Given 描 述 前 置 条 件 ，When 描 述 操作 ， 而 Then 描 述 
期 望 的 结果 。 如 果 测 试 没有 前 置 条 件 (这 些 条 件 通常 是 使 用 注解 Before 和 
@BeforeClass 设 置 的 )， 则 可 省 略 Given。 

完全 依靠 注释 指出 测试 的 目标 ， 因 为 使 用 IDE 执 行 测试 时 ， 注 释 不 会 出 
现 ， 它 们 也 不 会 出 现在 CI 工具 或 构建 工具 生成 的 报告 中 。 








除 编写 测试 外 ， 你 还 需要 运行 它们 。 由 于 我 们 使 用 的 是 Gradle， 因 此 要 运行 测试 ， 可 从 命令 
符 执行 如 下 命令 : 
$ gradle test 


Intelli] IDEA 提 供 了 一 个 极 佳 的 Gradle 任 务 模型 ， 可 通过 选择 菜单 View > Tool Windows > 

















Gradle 访 问 。 它 列 出 了 使 用 Gradle 可 运行 的 所 有 任务 ， 其 中 一 个 是 测试 。 








如 何 运行 测试 由 你 决定 一 一 可 使 用 你 认为 合适 的 任何 方式 ， 只 要 确保 运行 所 有 测试 即 可 。 
1. 测试 
首先 检查 棋子 是 否 放 在 3 x 3 棋盘 的 边界 内 : 


package com.packtpublishing.tddjava.ch03tictactoe; 
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impo 
impo 
impo 
impo 


publ 


rt org.junit.Before; 

rt org.junit.Rule; 

rt org.junit.Test; 

rt org.junit.rules.ExpectedException; 


ic class TicTacToeSpec { 


@Rule 

public ExpectedException exception = 
ExpectedException.none(); 

private TicTacToe ticTacToe; 


@Before 
public final void before() { 
ticTacToe = new TicTacToe(); 


@Test 


public void whenxOutsideBoardThenRuntimeException\() 


{ 


exception.expect (RuntimeException.class); 


ticTacToe.play (5, 2); 


} 





} 
| 棋子 放 在 超出 义 轴 边界 的 地 方 时 ,将 引发 RuntimeException 异 常 。 




















这 个 测试 中 ， 我们 指出 调用 方法 ficTacToe.play(5，2) 时 ， 期 望 的 结果 是 引 


Runtime 


运行 这 个 


法 后 ， 测 试 也 应 不 能 通过 ， 因 为 它 没有 引发 异常 Ru 





因为 实现 


play， 并 




















| 发 


Exception 异 常 。 这 个 测试 既 简 短 又 容易 ， 要 让 它 通 过 应 该 也 很 容易 : 只 需 创 建 方法 
确保 它 在 参数 X 小 于 1 或 大 于 3 ( 棋盘 是 3 x 3 的 ) 时 引发 Runt imei 


Exception 异 常 。 你 应 


测试 三 次 : 第 一 次 运行 时 ， 它 应 该 不 能 通过 ， 因 为 此 时 还 没有 方法 play; 添加 这 个 方 





了 与 这 个 测试 相关 联 的 所 有 代码 。 


2. 实现 
明确 什么 情况 下 应 引发 异常 后 ， 实 现代 码 编写 起 来 应 该 很 简单 : 


package com.packtpublishing.tddjava.ch03tictactoe; 


publ 


























ic class TicTacToe { 


public void play (int x, int y) { 
i 0 el 
throw 

















Exception; 第 三 次 运行 时 应 该 通 





ntimel 
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new RuntimeException("X is outside board"); 


} 
正如 你 看 到 的 ， 这 里 只 包含 让 测试 能 够 通过 的 最 少 代码 ， 而 没有 任何 多 余 代码 。 




















throw newRuntimeException();。 我 通常 将 “最 少 ”理解 为 “在 合理 范围 内 


1 入 939 
可 能 2 o 


这 里 没有 将 数字 相 加 ,也 没有 返回 任何 值 ， 其 根本 目标 是 以 极 快 的 速度 做 细微 的 修改 ( 还 记 
得 前 面 提 到 的 乒乓 球 运动 吗 ? )。 至 此 ,我 们 完成 了 “ 红 灯 - 绿 灯 ” 部 分 , 但 这 些 代码 的 改进 空间 
不 大 ， 因 此 不 重 构 。 

下 面 进入 下 一 个 测试 。 

3. 测试 

这 个 测试 与 前 一 个 测试 几乎 相同 ,但 验证 的 是 Y 轴 : 

@Test 
public void whenYOutsideBoardThenRuntimeException() { 


exception.expect (RuntimeException.class); 
ticTacToe.play (2, 5); 





EE CYA 有 些 TDD 践 行者 从 字面 意思 上 和 解读“ 最少”， 让 方法 play 只 包含 代码 行 




















} 


8 


棋子 放 在 超出 Y 轴 边界 的 地 方 时 ， 将 引发 RuntimeException 异 常 。 





站 


4. 实现 
这 个 规范 的 实现 几乎 与 前 一 个 相同 ， 只 需 在 参数 Y 不 在 指定 范围 内 时 引发 异常 即 可 : 


public void play (int x, int y) { 





于 下 区 有 下 下 下 这 人 3) 作 

throw 

new RuntimeException("X is outside board"); 
} elBe TE (yy 1 | 总 3) A 

throw 


new RuntimeException("X is outside board"); 
} 
为 让 最 后 一 个 测试 通过 ， 添 加 一 条 “检查 参数 Y 是 否 在 棋盘 内 ”的 else 子 句 。 
下 面 编写 当前 需求 涉及 的 最 后 一 个 测试 。 
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5. 测试 
确定 棋子 在 棋盘 边界 内 后 ， 还 需 确保 它 放 在 未 被 别 的 棋子 占据 的 地 方 : 


@Test 

public void whenOccupiedThenRuntimeException() { 
ticTacToe.play (2, 1); 
exception.expect (RuntimeException.class); 
ticTacToe.play (2, 1); 




















} 





棋子 放 在 被 别 的 棋子 占据 的 地 方 时 ， 将 引发 RuntimeException 异 常 。 

















这 就 是 最 后 一 个 测试 。 编 写实 现 后 ， 即 可 认为 第 一 个 需求 完成 了 。 





6. 实现 
为 实现 最 后 一 个 测试 , 应 将 既 有 棋子 的 位 置 存储 在 一 个 数组 中 。 每 当 玩 家 放置 新 棋子 时 ,都 
应 确认 棋子 放 在 未 占用 的 位 置 ， 和 否则 引发 异常 : 


private chardotewmtlll boargd =. {{ "NO, NO NO 
(NO NO NO NOM YO NO 








public void play (int x, int y) { 


下 

throw 

new RuntimeException("X is outside board"); 
} else if (y <1 ||y>3){ 

throw 


new RuntimeException("Y is outside board"); 





if (boadrd[w = 1][y = 1] 1=. NO 世 

throw 

new RuntimeException("Box is occupied"); 
} else { 

boardlx: = 1][¥ =-1] ££ "3 


} 
} 


我 们 检查 要 放置 棋子 的 位 置 是 否 被 占用 ， 如 果 未 占用 ， 就 将 相应 数组 元 素 的 值 从 空 (\0 ) 改 
为 被 占用 (X )。 注 意 ， 我 们 还 没有 记录 棋子 是 谁 (X 还 是 O ) 的 。 

7. 重 构 

这 些 代 码 虽 然 满 足 了 测试 指定 的 需求 , 但 有 点 令 人 迷惑 。 如 果 有 人 阅读 这 些 代码 , 会 搞 不 清 
楚 方法 play 的 目的 。 应 重 构 这 个 方法 ， 将 其 中 的 代码 放 在 多 个 方法 中 。 重 构 后 的 代码 类 似 于 下 
面 这 样 : 
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public voidq play (int x, int y) { 
checkAxis (x); 
checkAxis (y); 
setBox(x, y); 

} 


private void checkAxis(int axis) { 
if (axis < 1 || axis > 3) { 
throw 
new RuntimeException("X is outside board"); 


} 





private void setBox(int x, int y) { 


TF" Board [i = LI [YY = 4) WO 

throw 

new RuntimeException("Box is occupied"); 
} else { 

board[x - 1][y - 1] = "X'; 


} 
} 


这 个 重 构 过 程 中 ， 没 有 改变 方法 play 的 功能 ， 其 行为 与 以 前 完全 相同 ， 但 代码 的 可 读 性 更 
强 了 。 由 于 我 们 有 和 覆盖 了 所 有 功能 的 测试 ， 因此 不 用 害怕 重 构 时 犯错 。 只 要 确保 所 有 测试 都 通过 
且 重 构 时 没有 引入 新 行为 ， 就 可 以 放心 大 胆 地 修改 代码 。 


完整 的 源 代 码 可 在 Git 仓 库 taq-java-ch03-tic-tac-toe 的 分 支 01-exceptions 
( https://bitbucket.org/vfarcic/tdd-java-ch03-tic-tac-toe/branch/01-exceptions ) 中 找到 。 

















3.4.2 需求 2 
现在 处 理 轮 到 哪个 玩家 落 子 的 问题 。 


| 需要 提供 一 种 途径 ， 用 于 判断 接 下 来 该 谁 落 子 。 


可 将 这 个 需求 分 成 三 个 测试 : 
口 玩家 X 先 下 ; 
口 如 果 上 一 次 是 x 下 的 ， 接 下 来 将 轮 到 o 下 ; 
口 如 果 上 一 次 是 o 下 的 ， 接 下 来 将 轮 到 x 下 。 
到 目前 为 止 ， 我 们 还 未 使 用 过 JUnit 汤 言 。 要 使 用 断言 ， 需 要 导入 org .junit .Assert 类 中 
的 静态 ( static ) 方法 : 


import static org.junit.Assert.*; 
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Assert 类 中 的 方法 都 非常 简单 ， 它 们 大 都 以 assert 打 头 。 例 如 ，assertEquals 对 两 个 对 
象 进行 比较 : assertNotEquals 验 证 两 个 对 象 不 同 ， 而 assertArrayEquals 验 证 两 个 数组 相 
同 。 这 两 个 断言 都 有 很 多 重 载 版 本 ， 因 此 几乎 能 够 对 任何 类 型 的 Java 对 象 进行 比较 。 


在 这 里 ,我 们 需要 比较 两 个 字符 ， 其 中 第 一 个 是 预期 的 字符 ， 而 第 二 个 是 方法 nextPlayer 
返回 的 实际 字符 。 


现在 编写 这 些 测试 及 其 实现 。 




















先 编写 测试 ， 再 编写 实现 代码 
这 样 做 的 好 处 是 : 可 确保 编写 的 代码 是 可 测试 的 ， 且 每 行 代码 都 有 对 应 的 


人 AL 

测试 。 

电 通过 先 编写 或 修改 测试 , 开发 人 员 可 在 编写 代码 前 专注 于 需求 。 这 是 与 完成 
实现 后 再 编写 测试 的 主要 差别 所 在 。 测试 先行 的 另 一 个 好 处 是 , 可 避免 原本 应 为 
质量 保证 的 测试 沦 为 质量 检查 。 


1. 测试 
玩家 X 先 下 : 
@Test 


public void givenFirstTurnWhenNextPlayerThenX() { 
assertEquals('X', ticTacToe.nextPlayer()); 


} 
| 应 该 是 玩家 X 先 下 。 ] 


这 个 测试 应 该 是 不 言 自明 的 : 我 们 期 望 nextPlayer 返 回 x。 如 果 现 在 运行 这 个 测试 ， 将 发 
现 它 都 不 能 通过 编译 , 这 是 因为 还 没有 方法 nextPlayer。 我 们 的 任务 是 编写 方法 nextPlayer， 
并 确保 它 返 回 正确 的 值 。 


2. 实现 


其 实 根本 不 需要 检查 玩家 x 是 否 先 下 ， 因 为 就 目前 而 言 ， 只 需 让 nextPlayer 返 回 x 就 能 让 这 
个 测试 通过 。 后 面 的 测试 将 要 求 我 们 修改 这 个 方法 的 代码 : 


public char nextPlayer() { 
return 'X'; 





























} 
3. 测试 
现在 需要 确保 让 玩家 轮流 下 。 玩 家 Xx 下 棋 后 ， 应 轮 到 玩家 0， 然 后 再 轮 到 玩家 xX， 以 此 类 推 : 
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@Test 

public void givenLastTurnWasXWhenNextPlayerThenO() 
ticTacToe.play (1, 1); 
assertEquals('O', ticTacToe.nextPlayer()); 


} 
| 如 果 前 一 次 是 玩家 X 下 的 ， 接 下 来 应 轮 到 玩家 0。 





4. 实现 
为 跟踪 接 下 来 该 谁 下 ， 需 要 存储 前 一 次 下 棋 的 玩家 : 
private char lastPlayer = '\0'， 


buUublie vord play (nt Sy Tnt 
checkAxis (x) 
checkAxis (y); 
setBox(x, y) 
lastPlayer = nextPlayer(); 


} 


public char nextPlayer() 
if (lastPlayer == 'X' 
return 'O'; 


{ 
yc 
} 
return 'X'; 
} 
你 很 可 能 已 经 进入 状态 。 测试 很 小 日 易于 编写 , 有 了 足够 的 经 验 后 , 编写 一 个 测试 只 需 一 分 
钟 甚至 几 秒 钟 ， 而 编写 实现 所 需 的 时 间 也 差不多 ， 甚 至 更 短 。 
5. 测试 


我 们 终于 可 以 检查 玩家 O 下 后 是 不 是 轮 到 玩家 X 了 。 


| 如 果 前 一 次 是 玩家 0 下 的 ， 接 下 来 应 是 玩家 X 下 。 























即使 什么 都 不 用 做 ， 这 个 测试 也 能 通过 。 因 此 它 毫 无 用 处 ， 应 当 删 除 。 如 果 编 写 这 个 测试 ， 
将 发 现 它 存在 错 报 问题 ， 在 没有 修改 实现 的 情况 下 就 能 通过 。 你 可 以 自己 试 一 试 。 编 写 测试 后 ， 
如 果 它 在 没有 编写 任何 实现 代码 时 就 能 通过 ， 应 将 其 删除 。 














可 在 Git 仓 库 taq-java-ch03-tic-tac-toe 的 分 支 02-next-playetr ( https://bitbucket.org/ 
vfarcic/tdd-java-ch03-tic-tac-toe/branch/02-next-player ) 中 找到 源 代 码 。 
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3.4.3 需求 3 





现在 考虑 这 个 游戏 的 获胜 规则 。 相 比 于 前 面 的 代码 ,这 部 分 工作 更 繁琐 。 我 们 必须 检查 所 有 
可 能 获胜 的 情况 ， 只 要 满足 其 中 一 个 ， 就 宣布 相应 玩家 获胜 。 


| 最 先 在 水 平 、 重 直 或 对 角 线 上 将 自己 的 3 个 标记 连 起 来 的 玩家 获胜 。 


要 检查 同一 玩家 的 3 颗 棋 子 是 否 连 成 了 线 ， 需 要 检查 水 平方 向 、 垂 直方 向 和 对 角 线 。 
1. 测试 
下 面 首先 定义 方法 play 的 默认 返回 值 : 


@Test 

public void whenPlayThenNoWinner () 

{ 
String actual = ticTacToe.play (1,1); 
assertEquals ("No winner", actual); 


} 
如 果 不 满足 获胜 条 件 ， 则 无 人 获胜 。 


2. 实现 
默认 返回 值 总 是 最 容易 实现 的 ， 这 里 也 不 例外 : 


public String play (int x, int y) { 
checkAxis (x); 
checkAxis (y); 
setBox(x, y); 
lastPlayer = nextPlayer(); 
return "No winner"; 




















} 
3. 测试 
指定 默认 结果 ( 没有 人 获胜 ) 后 ， 处 理 各 种 获胜 条 件 : 


@Test 
public void whenpPplayAndWholeHorizontalLineThenWinner() { 
ticTacToe.play (1, 1); // xX 
ticTacToe.play (1, 2); // 0 
ticTacToe.play (2, 1); // xX 
(2 





ticTacToe.play (2, 2); // 0 
String actual ticTacToe.play (3, 1); // 又 
assertEquals ("XxX is the winner", actual); 
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| 一 个 玩家 的 棋子 占据 整 条 水 平 线 就 赢 了 。 


4. 实现 


为 让 这 个 测试 通过 , 需要 检查 是 否 有 水 平 线 全 被 当前 玩家 的 棋子 占据 。 到 目前 为 止 , 我 们 根 
本 不 关心 存储 到 数组 board 中 的 值 是 什么 ， 但 现在 不 但 要 记录 哪些 棋盘 格 是 空 的 ， 还 需 记录 各 个 
棋盘 格 被 哪个 玩家 占据 : 


public String play (int x, int y) { | 
checkAxis (x); 


(x 
checkAxis (y); 
lJastPlayer = nextPlayer(); 
setBox(x, y, lastPlayer); 
for (int index = 0; index < 3; index++) { 





























if (board[0] [index] == lastPlayer && 
board[1] [index] == lastPlayer && 
board[2] [index] == lastPlayer) { 
return lastPlayer + " is the winner"; 
} 
} 
return "No winner"; 
} 
private void setBox(int x, int y, char lastPlayer) 
t 
i board[lx ~ TY = LE Hv EN A 
throw 
new RuntimeException("Box is occupied"); 
} else { 
board[x - ll][ly - 1] = lastPlayer; 
} 
} 
5. 重 构 


前 面 的 代码 能 够 让 测试 通过 , 完成 了 尽快 让 测试 通过 的 使 命 , 但 并 非 没 有 改进 的 空间 。 现 在 
我 们 有 了 确保 预期 行为 完整 性 的 测试 ， 可 对 代码 进行 重 构 : 





private static final int SIZE = 3; 
DUBLEe. Str1ling Blay (Lint x Tn yy) .{ 


checkAxis (x); 
checkAxis (y); 
lastPlayer = nextPlayer(); 
setBox(x, y, lastPlayer); 
if (isWin()) { 
return lastPlayer + " is the winner"; 
} 


return "No winner"; 
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private boolean iswWwin() { 
fo TNE 0 TIDE 和) 开 
if (board[0] [i] + board[1] [i] + board[2] [i] 
二 三 (lastPrlayer * SIZE)) 1 
return true; 
} 
} 


return false; 


} 
重 构 后 的 解决 方案 看 起 来 更 好 。play 依 然 很 得， 很 容易 理解 。 将 实现 获胜 逻辑 的 代码 移 到 一 
个 独立 的 方法 中 ， 不 仅 让 方法 play 的 目的 变 得 清晰 ， 还 能 让 我 们 独立 添加 检查 获胜 条 件 的 代码 。 
6. 测试 
我 们 还 需 检 查 是 否 有 垂直 线 完全 被 某 个 玩家 占据 : 
@Test 


public void whenplayAndWholeVerticalLineThenWinner() { 
ticTacToe.play (2, 1); // Xx 


























ticTacToe.play (1, 1); // 0 
ticTacToe.play (3, 1); // xX 
ticTacToe.play (1, 2); // 0 
ticTacToe.play (2, 2); // XxX 


ticTacToe.play (1, 3); // 0 
assertEquals("O is the winner", actual); 


} 
| 一 个 玩家 的 棋子 占据 整 条 重 直 线 就 赢 了 。 











这 个 实现 应 该 与 前 一 个 类 似 。 前 面 在 水 平方 向 上 做 了 检查 , 现在 需要 在 垂直 方向 上 做 同样 的 











private boolean isWwin() { 
int playerTotal = lastPlayer * 3; 
A OV a ee 2 Hy 
if (board[0] [i] + board[1][i] + board[2] [i] 
== playerTotal) { 
return true; 
} else if (playerTotal == ) 


return true; 
上 
} 


return false; 


} 
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8. 测试 
水 平 线 和 垂直 线 都 处 理 后 ， 该 将 注意 力 转向 对 角 线 了 : 


@Test 


public void whenPplayAndTopBottomDiagonalLineThenWinner() { 
ticTacToe.play (1, 1); // Xx 





ticTacToe.play (1, 2); // 0 
ticTacToe.play (2, 2); // xX 
ticTacToe.play (1, 3); // 9 


String actual = a Dlay(3; B37 /YO 
Be Ee eu is the winner", actual); 





一 个 玩家 的 棋子 占据 从 左上 角 到 右 下 角 的 整 条 对 角 线 就 赢 了 


由 于 这 里 只 涉及 一 条 线 ， 因 此 可 直接 检查 ， 无 需 使 用 循环 : 


private boolean isWin() { 








邮 int playerTotal = lastPlayer * 3; 
for (int 1 = O03 1 < SIZE; 工 ++) { 
电 if (board[0] [i] + board[1] [i] + board[2] [i] 


playerTotal) { 
return true; 
} else if (playerTotal == ) 


return true; 


| 


if ((board[0] [0] + board[1][1] + boardq[2][2]) 
== playerTotal) { 
return true; 
} 
return false; 


} 
10. 测试 
最 后 ， 还 有 最 后 一 个 可 能 的 获胜 条 件 需 要 人 处理: 


@Test 
public void whenPlayAndBottomTopDiagonalLineThenWinner() { 
ticTacToe.play (1, 3); // xX 
ticTacToe.play (1, 1); // 0 
ticTacToe.play (2, 2); // XxX 
( 





ticTacToe.play (1, 2); // 0 
String actual ticTacToe.play (3, 1); // 0 
assertEquals ("XxX is the winner", actual); 
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一 个 玩家 的 棋子 占据 从 左下 角 到 右上 角 的 整 条 对 角 线 就 赢 了 。 


11. 实现 
这 个 测试 的 实现 应 该 与 前 一 个 几乎 完全 相同 : 


private boolean 1sSWin() { 
int playerTotal = lastPlayer * 3; 
A CE OV ra ee 0 2 
if (board[0] [i] + board[1] [i] + board[2] [i] 
playerTotal) { 
return true; 
} else if (playerTotal == ) 


return true; 


} 


} 
if ((board[0][0] + board[1][1] + board[2][2]) 
=eplayerTotal) * 
return true; 
} else if (playerTotal == (board[0] [2] + board[1][1] + 
board[2] [0])) { 
return true; 
} 
return false; 


} 
12. 重 构 


处 理 对 角 线 时 ， 所 做 的 计算 看 起 来 不 太 好 ， 也 许 重 用 既 有 的 循环 更 合适 : 


private boolean iswWwin() { 
int playerTotal = lastPlayer * 3; 
char diagonall = '\0'， 
char diagonal2 = '\0'， 
for {int i = 0; i < SIZE; 1i4++) { 
diagonall += board[i][i]; 
diagonal2 += board[i][SIZE - i - 1]; 
if (board[0] [i] + board[1] [i] + board[2] [i]) = 
playerTotal) { 
return true; 
} else if (playerTotal == ) { 
return true; 


} 

} 

if (diagonall == playerTotal || diagonal2 == playerTotal) { 
return true; 

} 


return false; 
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可 在 Git 仓 库 tad-java-ch03-tic-tac-toe 的 分 支 03-wins ( https://bitbucket.org/vfarcic/ 
tdd-java-ch03-tic-tac-toe/branch/03-wins ) 中 找到 源 代码 。 


下 面 处 理 最 后 一 个 需求 。 


3.4.4 需求 4 
现在 缺失 的 唯一 一 项 内 容 是 如 何 处 理 平 局 。 


| 所 有 格子 都 占 满 则 为 平局 。 


1. 测试 
可 以 通过 填 满 棋盘 的 所 有 格子 测试 平局 结果 : 



































@Test 
public void whenAllBoxesAreFilledThenDraw() { 
ticTacToe.play (1, 1); 
ticTacToe.play (1, 2); 
ticTacToe.play (1 3) 
ticTacToe.play (2, 1); 
ticTacToe.play (2, 3); 
ticTacToe.play (2, 2); 
ticTacToe.play (3, 1); 
ticTacToe.play (3, 3); 








String actual = ticTacToe.play (3, 2); 
dort ou result is draw", actual); 






































仿 查 是 否 为 平局 非常 简单 一 一 只 需 检查 是 否 已 占 满 整个 棋盘 。 为 此 ， 可 遍历 数组 board: 








public String ee pl ol oh nt 
checkAxis (x 
checkAxisl(y 
lastPlayer = Ey 
setBox(x, y, lastPlayer); 


if (isWin()) { 

return lastPlayer + " is the winner"; 
} else if (isDraw()) { 

return "The result is draw"; 
} else { 


return "No winner"; 
} 
} 


private boolean isDraw() { 
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fOr 


} 


(int x = 0; x < SIZE; x++) { 
for (int y = 0; y < SIZE; y++) { 
if (board[x][y] == '\0') { 
return false; 
} 
} 


return true; 


} 
3. 重 构 


虽然 方法 iswin 与 最 后 一 个 测试 无 关 ， 但 也 可 重 构 。 例 如 ， 我 们 无 需 检 查 所 有 获胜 条 件 ， 而 
只 需 检 查 与 最 后 一 个 棋子 的 位 置 相关 的 获胜 条 件 。 最 终 的 版 本 类 似 于 下 面 这 样 : 





private 
int 


boolean isWwin(int x, int y) { 
playerTotal = lastPlayer * 3; 


char horizontal, vertical, diagonall, diagonal2; 


horizontal = vertical = diagonall = diagonal2 = 


fGE 


} 
了 


} 


(int i = 0; i < SIZE; i++) { 
horizontal += board[il][ly - 1]; 
vertical += board[x - 1] [i]; 
diagonall += board[i][i]; 

diagonal2 += board[i][SIZE - i - 1]; 


(horizontal == playerTotal 
| | vertical == playerTotal 
1|| diagonall == playerTotal 
1|| diagonal2 == playerTotal) { 


return true; 


return false; 


} 


可 随时 对 代码 的 任何 一 部 分 进行 重 构 , 只 要 此 时 所 有 测试 均 通 








重 构 最 容易 也 最 快 , 但 重 构 几 天 、 几 月 甚至 几 年 前 编写 的 代码 更 可 贵 。 
构 它 的 最 佳 时 机 , 至 于 代码 是 谁 写 的 以 及 什么 时 候 写 的 都 不 重要 , 毕竟 让 代码 变 和 





值得 去 做 的 好 事 。 


可 在 Git 仓 库 tddq-java-c 


NO 

















前 过 。 通常 代码 编写 后 立即 进行 














tdd-java-ch03-tic-tac-toe/branch/04-draw ) 中 找到 源 代码 。 


3.5 代码 复 























发 现 可 让 代码 更 好 就 是 重 





号 更 好 总 














是 一 件 


h03-tic-tac-toe 的 分 支 04-draw ( https://bitbucket.org/vfarcic/ 


前 面 的 练习 中 , 我 们 没有 使 用 代码 覆盖 率 工 具 , 原因 是 我 们 想 让 你 专注 于 “ 红 娄 -绿灯 -- 重 构 ” 


过 程 。 编 写 一 个 测试 ， 发 现 它 不 能 i 
构 代 码 使 其 变 得 更 好 , 并 重复 这 个 过 程 。 




















过 ; 编写 实现 代码 ， 发 现 所 有 测试 都 通过 ; 只 要 有 机 会 
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盖 率 工具 可 回答 这 个 问题 。 应 该 使 用 这 些 工 具 吗 ? 也 许 仅 在 刚 开 始 使 用 TDD 时 才 使 用 。 下 面 说 明 
其 中 原因 。 刚 开始 使 用 TDD 时 ,你 很 可 能 遗漏 一 些 测试 , 或 实现 的 代码 比 测试 要 求 的 多 。 这 些 情 
况 下 ,使 用 代码 覆盖 率 工具 是 一 种 从 自己 的 错误 中 学 习 的 极 佳 方式 。 随 着 TDD 使 用 经 验 日 益 丰 富 ， 
你 会 越 来 越 不 需要 这 样 的 工具 。 届 时 编写 测试 以 及 刚好 能 让 它们 通过 的 代码 时 ， 无 论 有 没有 
JaCoCo 这 样 的 工具 , 代码 覆盖 率 都 会 很 高 。 肯 定 有 一 小 部 分 代码 未 被 测试 覆盖 ,因为 你 能 够 针对 
哪些 代码 不 值得 测试 做 出 明智 的 决定 。 


JaCoCo 等 工具 主要 设计 用 于 验证 实现 代码 后 编写 的 测试 是 否 提供 了 足够 的 覆盖 率 。TDD 中 ， 
我 们 采取 反 转 的 做 法 ， 即 先 编写 测试 ， 再 编写 实现 。 


然而 ， 我 们 依然 建议 你 将 JaCoCo 作 为 学 习 工 具 。 至 于 以 后 是 否 使 用 ， 由 你 自己 决定 。 
要 想 在 Gradle 中 启用 JaCoCo， 可 在 文件 bui1lg.gradle 中 添加 如 下 内 容 : 



















































































apply plugin: 'Jjacoco' 


这 样 , 每 当 运 行 测试 时 , Gradle 都 将 收集 JaCoCo 指 标 。 使 用 Gradle 目 标 ( target )jacocoTest- 
Report 可 将 这 些 指标 转换 为 漂亮 的 报告 。 下 面 再 次 运行 前 面 的 测试 ， 看 看 代码 覆盖 率 有 多 高 : 





$ gradle clean test jacocoTestReport 


最 终结 果 存 储 在 目录 bui1d/reports/jacoco/test/html 下 的 报告 中 ,结果 根据 这 个 练习 
中 实现 的 解决 方案 而 异 ; 我 得 到 的 结果 表明 , 指令 覆盖 率 为 100%, 而 分 支 覆 盖 率 为 96%。 还 有 4% 
的 分 支 未 覆盖 ， 这 是 因为 没有 测试 玩家 将 棋子 坐标 指定 为 0 或 负数 的 情形 。 实 现代 码 考虑 了 这 样 
的 情形 ， 但 没有 覆盖 它 的 测试 。 总 体 而 言 ， 覆 盖 率 还 是 非常 高 的 。 














BB tdd-java-ch03-tic-tac-toe > 出 com.packtpublishing.tddjava.ch03tictactoe > @ TicTacToe 

TicTacToe 

Element Missed Instructions*> Cov.$ Missed Branches Cov.$ Missed$ Cxty$ Missed$ Lines$s Misseds Methods 
© isWin(int, int) 100% SS 100% 0 6 0 10 0 工 
© TicTacToe() 一 一 100% n/a 0 1 0 3 0 1 
© play(int, int 一 一 一 100% ”PE 100% 0 3 0 9 0 1 
© setBox(int, int, char) em 100% mu 100% 0 2 0 4 0 1 
© isDraw()} 一 -一 1009% PEEEEEEEEE 100% 0 4 0 5 0 1 
© checkAxis(int) 二 100% ee 75% 1 3 0 3 0 1 
© nextPlayer() | 100% a 100% 0 2 0 3 0 1 
Total 0 of 272 100% 1of28 96% 生 21 0 37 0 了 











JaCoCo 将 被 加 入 源 代 码 ， 这 些 源 代码 可 在 Git 仓 库 tad-java-ch03-tic-tac-toe 的 分 支 
05-jacoco (https://bitbucket.org/vfarcic/tdd-java-ch03-tic-tac-toe/branch/05-jacoco ) 中 找到 。 





3.6 更 多 练习 
前 面 开 发 了 “ 井 字 游戏 ”的 最 常用 版 本 ,作为 额外 练习 ， 请 从 维基 百科 ( http://en.wikipedia. 
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org/wiki/Tic-tac-toe ) 选择 这 个 游戏 的 其 他 版 本 ， 并 使 用 “ 红 灯 - 绿 灯 - 重 构 ” 流 程 实现 。 完 成 后 ， 
通过 实现 AI 让 计算 机 充当 玩家 O。 由 于 “和 井 字 游 戏 ”通常 以 平局 告终 ， 因 此 你 只 要 实现 这 样 的 Ai 
即 可 ， 即 不 管 玩家 X 怎 么 走 都 至 少 能 打 成 平 局 。 


完成 这 些 练习 时 , 一 定 要 快速 前 进 , 就 像 打 乒乓 球 一 样 。 另外 , 最 重要 的 是 , 别 忘 了 使 用 “ 红 
灯 - 绿 灯 - 重 构 ” 流 程 。 














3.7 小 结 





我 们 使 用 “ 红 灯 - 绿 灯 - 重 构 ” 流 程 完成 了 “并 字 游 戏 "， 这 些 示 例 本 身 都 很 简单 ， 易 于 理解 。 


本 章 并 非 要 深入 探讨 复杂 的 东西 (后 面 会 介绍 这 些 内 容 )， 而 是 要 让 你 养 成 反复 使 用 “ 红 灯 - 
绿灯 - 重 构 ” 流 程 的 习惯 。 


你 学 习 了 如 下 内 容 : 开发 软件 的 最 简单 方式 是 将 其 分 成 小 块 ; 设计 方案 脱胎 于 测试 ,而 不 是 
预先 采用 复杂 的 方法 进行 制定 ; 先 编写 测试 并 确定 未 通过 后 , 再 着 手 编写 实现 代码 ; 确定 最 后 一 
个 测试 未 通过 后 ， 就 能 肯定 它 是 有 效 的 〈 你 一 不 小 心 就 会 犯错 ， 编 写 总 是 能 够 通过 的 测试 )， 要 
实现 的 功能 还 不 存在 ; 测试 未 通过 后 ,编写 其 实现 代码 ; 编写 实现 时 ,力图 使 其 尽 可 能 简单 ， 只 
要 能 让 测试 通过 就 行 ， 而 不 试图 提供 完美 的 解决 方案 ; 不 断 重复 这 个 过 程 ， 直 到 认为 需要 对 代码 
进行 重 构 为 止 ; 重 构 时 不 能 引入 任何 新 功能 ( 即 不 改变 应 用 程序 的 行为 )， 而 只 是 对 代码 进行 改 
进 ， 使 其 更 容易 理解 和 维护 。 


下 一 章 将 详细 介绍 TDD 中 的 单元 ， 以 及 如 何 根据 这 些 单 元 创建 测试 。 
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第 4 章 
单元 测试 一 一 专注 十 当下 
而 非 过 往 








“要 打造 出 出 类 拔 革 的 作品 ， 你 必须 专注 于 最 细小 的 细节 。” 4 








乔治 . 阿玛尼 
前 面 说 过 ， 每 章 都 将 探索 一 个 不 同 的 Java 测 试 框架 。 这 一 章 也 不 例外 , 我们 将 使 用 TestNG 制 
定 规范 。 
在 前 一 章 , 我 们 练习 了 “ 红 灯 - 绿 灯 - 重 构 ” 过 程 。 虽然 使 用 了 单元 测试 , 但 未 深入 阐述 单元 
测试 在 TDD 中 的 工作 原理 。 本 章 将 拓展 前 一 章 介绍 的 知识 , 深入 阐述 单元 测试 的 定义 及 其 在 软件 
开发 方法 TDD 中 扮演 的 角色 。 











本 章 则 在 让 你 学 会 如 何 专 注 于 当前 要 开发 的 单元 ， 并 忽略 或 隔离 已 完成 的 单元 。 
熟悉 TestNG 和 单元 测试 后 ， 我 们 将 深入 介绍 下 一 个 应 用 程序 的 需求 并 开始 编写 代码 。 
本 章 涵 盖 如 下 主题 : 

口 单元 测试 ; 

口 TDD 中 的 单元 测试 ; 

口 TestNG ; 

口 “ 通 控 军 朋 ”的 需求 ; 

D 开发 “遥控 军 县 "; 

口 小 结 。 





4.1 单元 测试 


除非 系统 非常 小 ， 否 则 很 难 频繁 地 进行 手工 测试 。 要 避免 此 类 操作 ,唯一 的 办 法 是 使 用 自动 
化 测试 ; 要 缩短 和 降低 构建 、 部 署 和 维护 应 用 程序 的 时 间 和 成 本 ,唯一 有 效 的 方法 是 使 用 自动 化 
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则 试 。 为 卓有成效 地 管理 应 用 程序 ， 实 现 和 测试 代码 必须 尽 可 能 简单 ， 这 至 关 重 要 。 简 约 
http://www.extremeprogramming.org/rules/simple.html ) 是 极限 编程 ( XP ) 的 核心 价值 观 之 一 ,也 
是 TDD 和 一 般 性 编程 的 关键 所 在 ; 这 通常 是 通过 将 系统 分 成 细小 的 单元 实现 的 。 在 Java 中 ,单元 
就 是 方法 。 作 为 最 小 的 编程 单位 ,单元 提供 的 反馈 环 路 是 最 快 的 ， 因此 我 们 的 大 部 分 时 间 都 花 在 
思考 和 人 处理 它们 上 。 与 实现 方法 相对 应 的 是 单元 测试 ， 它 们 在 测试 中 的 分 量 最 重 。 


党 
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4.1.1 何 为 单元 测试 


单元 测试 (UT ) 是 一 种 实践 ， 要 求 我 们 对 每 个 隔离 的 小 型 代码 单元 进行 测试 。 单 元 通常 是 
方法 , 但 有 些 情况 下 ， 整 个 类 乃至 整个 应 用 程序 都 可 视 为 单元 。 要 编写 UT， 需 要 将 受 测 代码 同 
应 用 程序 的 其 他 部 分 隔离 。 最 理想 的 情况 是 , 要 么 系统 已 实现 这 样 的 隔离 ， 要么 可 通过 使 用 模拟 
对 象 实现 隔离 ( 模拟 对 象 将 在 第 6 章 更 深入 地 介绍 )。 如 果 特 定 方法 的 单元 测试 跨越 了 该 单元 的 边 
界 , 它 将 变 成 集成 测试 。 这 种 情况 下 ,测试 的 是 哪些 代码 将 变 得 不 那么 清晰 。 如 果 测 试 失 败 ， 问 
题 的 范围 将 急剧 增 大 ， 找 出 原因 的 工作 将 更 为 繁琐 。 



























































4.1.2 ”为 何 要 进行 单元 测试 


一 个 常见 的 问题 是 : 为 何 使 用 单元 测试 而 不 是 功能 和 集成 测试 。 在 严重 依赖 手动 测试 的 组 织 
中 ， 这 个 问题 尤为 突出 。 然 而 ， 这 个 问题 本 身 就 有 问题 。 单 元 测试 并 非 要 取代 其 他 类 型 的 测试 ， 
而 只 是 缩小 其 他 测试 的 范围 。 从 本 质 上 说 , 单元 测试 的 编写 比 其 他 任何 类 型 的 测试 都 更 容易 、 更 
快捷 ， 从 而 能 够 降低 成 本 、 缩 得 上 市 时 间 。 由 于 编写 并 运行 单元 测试 所 需 的 时 间 更 少 ,它们 通常 
能 够 更 快 发 现 问题 。 而 问题 发 现 得 越 早 ， 修 复 的 成 本 就 越 低 。Bug 出 现 后 ， 如 果 能 够 在 几 分 钟 内 
发 现 ， 则 与 几 天 、 几 周 乃 至 几 个 月 后 才 发 现 相 比 ， 修 复 将 容易 得 多 。 

































































4.1.3 ”代码 重 构 


代码 重 构 指 的 是 对 既 有 代码 的 结构 进行 修改 , 同时 不 改变 其 外 部 行为 。 重 构 旨 在 改进 既 有 代 
码 , 这 样 做 的 原因 很 多 : 提高 可 读 性 、 降 低 复杂 度 、 使 其 更 易于 维护 或 更 容易 扩展 等 。 不 管 重 构 
的 原因 是 什么 ,其 终极 目标 都 是 改进 代码 的 某 个 方面 ， 从 而 降低 技术 债务 : 减少 因 设 计 、 架 构 或 
编码 不 佳 而 需要 做 的 额外 工作 。 


通常 ,我 们 在 不 改变 行为 的 情况 下 做 一 系列 细微 的 修改 以 实现 重 构 。 通 过 缩小 修改 范围 , 我 
们 可 始终 确认 所 做 的 修改 没有 破坏 既 有 功能 。 而 要 绪 得 这 样 的 确认 , 唯一 有 效 的 办 法 是 使 用 自动 
化 测试 。 

单元 测试 的 一 大 优点 是 , 为 重 构 提 供 最 有 力 的 支持 。 如 果 没 有 自动 化 测试 确认 应 用 程序 依然 
像 期 望 的 那样 工作 , 重 构 将 风险 重重 。 昌 然 任 何 类 型 的 测试 都 可 用 于 提供 重 构 所 需 的 代码 覆盖 率 ， 
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元 测试 满足 的 测试 需求 通常 是 最 多 的 ， 但 功能 测试 和 集成 测试 也 不 可 或 缺 。 





但 大 多 数 情 况 下 ， 只 有 单元 测试 能 够 达到 要 求 的 细致 程度 。 


4.1.4 为 何不 只 使 用 单元 测试 





此 时 你 可 能 会 问 , 单元 测试 能 够 满足 所 需 的 测试 需求 吗 ? 不 幸 的 是 , 答案 是 否定 的 。 虽 然 单 
































其 他 类 型 的 测试 将 在 本 书后 面 更 详细 地 介绍 , 这 里 先 来 说 说 单元 测试 和 其 他 测试 的 几 个 重要 
|: 


口 单元 测试 旨 在 对 小 型 功能 单元 进行 检查 。 在 Java 中 , 这 些 单元 就 是 方法 。 对 于 所 有 外 部 依 
赖 ， 诸 如 对 其 他 类 、 方 法 或 数据 库 的 调用 等 ， 都 应 在 内 存 中 完成 ， 这 是 通过 使 用 模拟 对 
象 、 存 根 、 间 谍 、 伪 造 对 象 和 哑 元 对 象 实现 的 。 杰 拉 德 . 梅 萨 罗 斯 发 明了 一 个 更 通用 的 
术语 一 一 测试 蔡 身 ( http://en.wikipedia.org/wiki/Test_double ), 它 涵盖 了 前 述 各 种 对 象 。 单 
元 测试 很 简单 、 易 于 编写 日 运行 速度 很 快 ， 通常 在 所 有 测试 中 占据 的 分 量 最 大 。 

口 功能 测试 和 验收 测试 的 职责 是 核实 整个 应 用 程序 像 预期 的 那样 工作 。 这 两 种 测试 的 用 途 
不 同 , 但 目标 相似 。 单 元 测试 则 在 检查 代码 的 内 部 质量 ， 而 功能 测试 和 验收 测试 用 于 确 
保 整 个 系统 在 客户 或 用 户 看 来 能 够 正常 工作 。 为 编写 和 运行 这 些 测试 ,需要 付出 更 多 成 
本 和 劳动 ， 因 此 其 数量 通常 比 单元 测试 少 。 

口 集成 测试 旨 在 核实 各 个 单元 、 模 块 、 应 用 程序 力 至 系统 被 受 善 地 集成 在 一 起 。 你 可 能 
一 个 前 端 应 用 程序 ， 它 使 用 后 端 API， 而 后 端 API 又 与 一 个 数据 库 通 信 。 这 种 情况 下 ， 集 
成 测试 的 职责 是 核实 这 三 个 不 同 的 组 件 被 紧密 地 集成 在 一 起 ， 能 够 彼此 通信 。 执 行 集成 
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测试 前 ， 已 确认 所 有 单元 都 能 正常 工作 、 所 有 功能 测试 和 验收 测试 都 已 通过 ， 
测试 唯一 的 职责 是 确认 所 有 组 件 能 够 很 好 地 协同 工作 ， 所 以 其 数量 是 最 少 的 。 
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这 个 测试 金字 塔 表 明 ， 单 元 测试 的 数量 比 高 层 测 试 (UI 测试 、 集 成 测试 等 ) 多 得 多 。 为 何 会 

















这 样 呢 ?” 单 元 测试 的 编写 更 容易 ， 运 行 更 快 ， 提供 的 代码 覆盖 率 更 高 。 比 如 注册 功能 ,我 们 应 测 
试 下 述 情形 下 的 结果 : 用 户 名 为 空 、 密 码 为 空 、 用 户 名 或 密码 的 格式 不 正确 、 用 户 名 已 被 占用 等 。 
仅 为 测试 这 一 项 功能 , 就 可 能 需要 数 十 乃至 数 百 个 测试 ; 如 果 通 过 UI 运行 所 有 这 些 测试 , 代价 将 
非常 高 (需要 花 很 多 时 间 编 写 且 运行 缓慢 )。 相 反 ， 执 行 这 种 验证 的 单元 测试 很 容易 编写 且 运 行 
速度 快 。 如 果 使 用 单元 测试 覆盖 所 有 这 些 情形 , 我 们 就 只 需 编写 一 个 集成 测试 一 一 检查 UI 是 否 调 
用 了 正确 的 后 端 方法 。 从 集成 的 角度 看 , 细节 已 无 关 紧 要 , 因为 我 们 知道 单元 级 已 覆盖 所 有 情形 。 
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4.2 TDD 中 的 单元 测试 


TDD 中 单元 测试 的 编写 方式 有 何不 同 呢 ? 主要 是 编写 时 机 。 传统 做 法 是 在 实现 代码 完成 后 编 
写 单元 测试 , 而 TDD 中 的 顺序 相反 一 一 先 编写 测试 。 未 使 用 TDD 的 情况 下 , 单元 测试 用 于 验证 既 
ue 而 在 TDD 中 , 应 将 单元 测试 作为 驱动 开发 和 设计 的 动力 , 它们 定义 最 小 可 能 单元 的 行为 ， 

定 有 待 实 现 的 微型 需求 。 测试 指出 了 你 接 下 来 该 做 什么 以 及 该 做 到 什么 程度 为 止 , 至 于 要 完成 
的 工作 量 ， 则 随 测试 类 型 (单元 测试 、 功 能 测试 、 集 成 测试 等 ) 而 异 。TDD 中 ， 单 元 测试 指定 接 
下 来 应 完成 尽 可 能 小 的 任务 ， 即 一 个 方法 力 至 其 一 部 分 。 男 外 , TDD 还 要 求 我 们 遵守 一 些 设计 原 
则 ， 如 KISS ( keep it simple stupid ， 保 持 简单 )。 通 过 编写 范围 很 小 的 简单 测试 ， 可 确保 这 些 测 
试 的 实现 也 同样 简单 。 通 过 要 求 测试 不 使 用 外 部 依赖 ,可 确保 实现 代码 严格 遵守 关注 点 分 离 原则 。 
有 关 TDD 如 何 帮 助 我 们 编写 更 好 的 代码 , 还 有 很 多 其 他 的 例子 , 而 仅 使 用 单元 测试 是 无 法 带 来 这 
些 好 处 的 。 未 使 用 TDD 的 情况 下 ， 单 元 测试 将 只 用 于 测试 既 有 代码 ， 对 设计 毫 无 影响 。 


总 之 , 未 使 用 TDD 的 情况 下 ,单元 测试 的 主要 目标 是 验证 既 有 代码 ; 而 在 TDD 中 ,单元 测试 
是 预先 编写 的 ， 其 主要 目标 是 定义 需求 和 设计 ， 而 验证 只 是 副产品 。 与 实现 后 再 编写 测试 相 比 ， 
这 样 做 的 一 个 结果 是 产品 质量 更 高 。 

TDD 迫 使 我 们 详细 地 考虑 需求 和 设计 、 编 写 整洁 而 可 行 的 代码 , 以 及 创建 可 执行 的 需求 并 频 
繁重 构 。 另 外 ， 这 样 编写 的 单元 测试 的 代码 覆盖 率 极 高 ， 每 当 对 代码 进行 修改 后 ， 都 可 使 用 它们 
进行 回归 测试 。 未 使 用 TDD 的 情况 下 ， 单 元 测试 只 是 测试 ， 其 质量 也 是 不 确定 的 。 
































































































































































































































4.3 TestNG 


JUnit 和 TestNG 是 两 个 主要 的 Java 测 试 框架 。 前 一 章 已 使 用 JUnit 编 写 过 测试 ， 大 家 很 可 能 对 
其 工作 原理 有 深入 了 解 。TestNG 又 如 何 呢 ? 它 是 为 改进 JUnit 而 开发 的 ， 同 时 提供 了 一 些 JUnit 没 
有 的 功能 。 


接 下 来 的 几 小 节 将 总 结 这 两 个 框架 的 一 些 差 别 。 曾 述 这 些 差别 的 同时 , 我 们 还 将 力图 从 TDD 
单元 测试 角度 对 这 两 个 框架 进行 评价 。 























4.3.1 注解 @Test 


JUnit 和 TestNG 都 使 用 注解 erest 将 方法 指定 为 测试 .JUnit 要 求 使 用 arest 对 每 个 用 作 测 试 的 
方法 进行 注解 ,而 TestNG 同 时 人 允许 在 类 级 使 用 这 个 注解 。 以 这 种 方式 使 用 该 注解 时 ， 除 非特 别 指 
定 ， 和 否则 类 中 所 有 公有 方法 都 被 视 为 测试 : 


@Test 
public class DirectionSpec { 
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public void whenGetFromShortNameNThenReturnDirectionN() { 
Direction direction = Direction.getFromShortName('N'); 
assertEquals (direction, Direction.NORTH); 


} 


public void whenGetFromShortNameWThenReturnDirectionW() { 
Direction direction = Direction.getFromShortName('W'); 
assertEquals (direction, Direction.WEST); 


} 


这 个 示例 中 ， 我 们 给 Directionspec 类 指定 了 注解 @Test， 此 方法 whenGetFrom- 
ShortNameNThenReturnDirectionN 和 whenGetFromShortNameWThenReturnDirectionW 


都 被 视 为 测试 。 如 果 使 用 JUnit 编 写 上 述 代 码 ， 需 要 给 这 两 个 方法 都 指定 注解 erest。 





4.3.2 ”注解 @BeforeSuite、@BeforeTest、@BeforeGroups、 
@AfterGroups、 @AfterTest 和 和 @AfterSuite 


这 4 个 注解 都 没有 对 应 的 JUnit 注 解 。TestNG 可 使 用 XML 配置 将 测试 编组 为 套件 。 使 用 
eBeforeSuite 和 eaAfterSuite 注 解 的 方法 分 别 在 指定 套件 中 的 所 有 测试 运行 之 前 和 之 后 运行 。 
同样 , 使 用 eaBeforeTest 和 eafterTest 注 解 的 方法 分 别 在 测试 类 中 的 每 个 测试 运行 之 前 和 之 后 
运行 。 最 后 ， TestNG 测 试 还 可 组 织 为 编组 ， 而 注解 eaBeforeGroups 和 eaAfterGroups 让 你 能 人 够 
在 指定 编组 中 的 所 有 测试 运行 之 前 和 之 后 运行 某 些 方法 。 


实现 代码 之 后 编写 测试 时 ,这 些 注 解 很 有 用 , 但 在 TDD 中 它们 没有 太 大 的 用 武之 地 。 传 统 测 
试 通常 是 作为 一 个 独立 的 项 目 进行 规划 和 编写 的 , 而 TDD 要 求 我 们 每 次 编写 一 个 测试 , 并 确保 一 
切 都 尽 可 能 简单 。 最 重要 的 是 ,单元 测试 必须 能 够 快速 运行 ,因此 没有 必要 将 它们 分 成 套件 或 编 
组 。 测试 的 运行 速度 很 快 时 ,运行 部 分 测试 都 是 在 浪费 时 间 。 例如， 如 果 在 15 秒 内 能 够 运行 所 有 
测试 ,就 没有 必要 运行 部 分 测试 。 男 一 方面 ， 如 果 测 试 的 运行 速度 很 慢 , 通常 昭示 着 没有 将 外 部 
依赖 隔离 。 不 管 测试 运行 速度 慢 的 原因 是 什么 ， 都 不 能 将 运行 部 分 测试 作为 解决 方案 ,而 应 去 修 
复 问题 。 


男 外 ,功能 测试 和 集成 测试 通常 运行 速度 更 慢 ， 必须 以 某 种 方式 将 测试 分 开 。 然 而 ,最 好 在 
build.gradle 中 将 它们 分 离 ， 将 每 种 测试 作为 一 个 独立 的 任务 运行 。 















































































































































4.3.3 注解 eBeforeclass 和 @AfterClass 
这 些 注解 在 JUnit 和 TestNG 中 的 作用 相同 : 被 注解 的 方法 将 分 别 在 当前 类 中 的 所 有 测试 运行 


之 前 和 之 后 运行 。 唯 一 的 差别 是 ，TestNG 不 要 求 这 些 方法 是 静态 的 。 原因 是 这 两 个 框架 运行 测试 
方法 的 方式 不 同 : JUnit 运 行 每 个 测试 时 都 使 用 不 同 的 测试 类 实例 , 因此 要 让 这 些 方法 可 重用 , 必 
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须 将 它们 定义 为 静态 的 ; 而 TestNG 在 同一 个 测试 类 实例 中 运行 所 有 测试 , 因此 不 需要 将 这 些 方法 
定义 为 静态 的 。 
4.3.4 注解 eBeforeMethod 和 @AfterMethod 


这 些 注解 与 JUnit 注 解 eBefore 和 eaAfter 等 价 ， 被 注解 的 方法 将 在 每 个 测试 运行 之 前 和 之 后 


4.3.5 注解 参数 emest (enable = false) 


JUnit 和 TestNG 都 能 够 禁用 测试 。 为 此 ，JUnit 使 用 独立 的 注解 eaIignore， 而 TestNG 使 用 注解 
@Test 的 布尔 参数 enable。 从 功能 上 说 ， 这 两 种 做 法 的 工作 原理 相同 ， 唯 一 的 差别 是 编写 方式 。 

















4.3.6 ”注解 参数 @Test (expectedExceptions = SomeClass.class) 


在 这 个 方面 ，JUnit 占 据 了 优势 。 虽 然 这 两 个 框架 提供 的 指定 期 望 异常 的 方式 相同 ( 在 JUnit 
中 ， 参 数 为 expectea ), 但 JUnit 引 入 了 更 优雅 的 异常 测试 方式 一 一 规则 ( 第 2 章 使 用 过 )。 








4.3.7 TestNG 和 JUnit 差别 小 结 


这 两 个 框架 还 有 很 多 其 他 的 差别 , 但 为 简单 起 见 ， 本 书 没有 全 部 介绍 。 有 关 这 方面 的 更 详细 
言 息 ， 请 参阅 这 两 个 框架 的 文档 。 





| 有 关 JUnit 和 TestNG 的 更 详细 信息 ， 请 参阅 http://junit.org/ 和 http://testng.org/。 | 


TestNG 提 供 的 功能 更 多 ， 也 比 JUnit 更 先进 。 本 章 将 一 直 使 用 TestNG， 你 会 对 它 有 更 深入 的 
了 解 。 需 要 指出 的 一 点 是 , 我 们 不 会 使 用 其 任何 高 级 功能 ， 因 为 在 TDD 中 编写 单元 测试 时 , 很 少 
需要 用 到 。 功 能 测试 和 集成 测试 与 单元 测试 不 同 ,可 更 好 地 演示 TestNG 的 优越 性 ; 然而 ,你 将 在 
本 书后 面 看 到 ， 有 其 他 更 适合 编写 这 些 测试 的 工 


该 使 用 哪个 框架 呢 ? 如 何 选择 由 你 决定 ， 因 为 阅读 完 本 章 后 ， 你 将 获得 实际 使 用 JUnit 和 
TestNG 的 经 验 。 

















o 


4 














4.4 “还 控 军舰 ”的 需求 


我 们 将 完成 著名 编码 套路 Mars Rover 的 变种 ， 这 个 编码 套路 最 初 是 由 Dallas Hack Club 
( http://dallashackclub.com/rover ) 发 布 的 。 
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假设 有 一 艘 停留 在 海中 的 军舰 ， 鉴 于 现在 是 21 世 纪 ， 我 们 完全 可 以 遥控 它 。 


| 这 里 的 任务 是 创建 一 个 程序 ， 让 这 艘 军舰 能 够 在 海中 游 叉 。 ] 








鉴于 本 书 是 一 部 介绍 TDD 的 著作 , 而 本 章 的 主题 为 单元 测试 , 所 以 我 们 将 使 用 TDD 方 法 开发 
一 个 应 用 程序 ， 并 将 重点 放 在 单元 测试 上 。 前 一 章 学 习 了 TDD 理 论 ， 并 获得 了 实际 使 用 “ 红 灯 - 
绿灯 - 重 构 ”过 程 的 经 验 。 这 里 将 以 此 为 基础 ， 学 习 如 何 有 效 利用 单元 测试 。 具 体 地 说 ， 你 将 专 
注 于 当前 要 开发 的 单元 , 并 学 习 如 何 隔离 并 忽略 它 可 能 使 用 的 依赖 。 不 仅 如 此 ,你 还 将 尝试 每 次 
只 专注 于 一 个 需求 。 有 鉴于 此 ， 这 里 只 提供 粗略 的 需求 : 移动 海中 的 遥控 军舰 。 


为 简化 学 习 过 程 ， 所 有 的 支持 类 都 已 编写 好 并 进行 了 测试 。 这 让 你 能 够 专注 于 手头 的 任务 ， 


同时 确保 这 个 练习 简单 明了 。 Er 


4.5 开发 “遥控 军舰 ” 
首先 导入 既 有 的 Git 仓 库 。 

















4.5.1 创建 项 目 
首先 创建 项 目 : 
(1) 启动 IntelliJ IDEA。 如 果 打 开 了 既 有 项 目 ， 请 选择 File > Close Project 将 其 关闭 。 
你 将 看 到 类 似 于 下 图 的 屏幕 。 


tdd-java-ch03-tic-tac-toe 


projectJUnit Ct y l 
deal ts/t | x 上 
b- 
rene IntelliJ IDEA 
Version 14.1.3 


Fs-file 





从 Create NewProject 
ansible 

r¥ Import Project 
~/ldeaProjects/ansible 


fm-poc OE 


县 Check out from Version Control ~ 
GitHub 
CVS 

deaProjects/fs-gatewa , Git 
二 So Mercurial 





Fs-gateway 














闪 Configure ~ GetHelpv 
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HH 








(2) 为 从 Git 仓 库 导 入 项 目 ， 请 单 击 Check out from Version Control 并 选择 Git。 然 后 在 文本 村 
Git Repository URL 中 输入 https://bitbucket.org/vfarcic/tdd-java-ch04-ship.git， 并 单 击 按钮 Clone。 


Clone Repository 


Git Repository URL: |https://bitbucket. org/vFarcic/tdd-java-ch04-ship.git| | Test 











Parent Directory: | /home/vfarcic/IdeaProjects | 贺 





Directory Name: tdd-java-cho4-ship 





[EDI 本 到 


(3) 被 问 及 是 否 要 打开 这 个 项 目 时 ， 回 答 Yes。 接 下 来 将 出 现 对 话 框 Import Project from 
Gradle， 请 单 击 按钮 OK。 


Import Project from Gradle 


Gradle project: | /home/farcic/ideaprojects/tdd-java-cho4-ship/settings.gradle [ | 














口 Use auto-import 

癌 Create directories for empty content roots automatically 

O Use default gradle wrapper (not configured fol Jrrent projec 

OO Use customizable gradle wrapper ©@ Gradle wrapper customization in script, works with Gradle 1.7 or later 


© Use local gradle distribution 











Gradle home: | Jusr/lib/gradle/default | | 
Gradle JVM: [ [31.8 (java version "1.8. 0_45" path: /usr hibjivr java-8-oracle) 图 
Project format: | .idea (directory based) :| 





» Global Gradle settings 
| Cancel [ Help | 


(4) IDEA 将 花 些 时 间 下 载 文件 buila.gradle 中 指定 的 依赖 。 下 载 完 毕 后 ， 你 将 看 到 已 经 创 
建 了 一 些 类 和 相应 的 测试 。 














团 Project =| 四 幸 | 闲 - I 
7 Catdd-java-ch04-ship ( Project 
* DO.idea 
Y 户 src 
7 DD main 
口 java 
Y DH com.packtpublishing.tddja 
9 b Direction 
9 b Location 
Sb Planet 
Sb PoinNt 
Sb Ship 
y Djava 
© com.packtpublishing.tddja 
Eb DirectionSpec 
$b LocationSpec 
Eb PlanetSpec 
Eb PointSpec 
bb ShipSpec 
人 .ditignore 
(© build.gradle 
Im] README.md 
3 settings.gradle 
» Wl External Libraries 
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4.5.2 ”辅助 类 


假设 这 个 项 目 最 初 是 由 你 的 一 位 同事 开发 的 , 他 是 位 卓越 的 程序 员 和 TDD 战 行者 , 你 深信 他 
扁 写 的 测试 有 极 高 的 代码 覆盖 率 。 换 言 之 , 你 完全 可 以 依赖 他 已 做 的 工作 。 然 而 ,这 位 同事 还 未 
完成 这 个 项 目 就 去 度假 了 ,余下 的 工作 将 由 你 接手 完成 。 他 创建 了 所 有 辅助 类 : Direction、 
Location、Planet 和 Point。 你 注意 到 相应 的 测试 类 也 已 编写 好 ,它们 的 名 称 与 被 测试 的 类 相 
同 ,但 包含 后 缀 spec( 如 Directionspec )。 使 用 这 个 后 级 由 在 明确 这 样 一 点 : 它们 不 仅 用 于 
验证 代码 ， 还 是 可 执行 的 规范 。 


除 这 些 辅助 类 外 ， 还 有 另外 两 个 类 : Ship (实现 ) 和 shipspec (规范 /测试 )， 你 的 大 部 分 
时 间 都 将 花 在 完善 它们 上 。 你 将 在 shipspec 中 编写 测试 ， 再 在 Ship 类 中 编写 实现 代码 ( 与 本 书 
前 面 做 的 完全 相同 )。 


我 们 知道 ,测试 不 仅 提供 了 验证 代码 的 途径 ,还 是 可 执行 的 文档 。 因此 从 现在 开始 , 我 们 将 4 
测试 称 为 “规范 ”。 

每 次 编写 规范 或 实现 规范 的 代码 后 ， 我 们 都 将 运行 测试 。 从 命令 提示 符 执行 命令 graale 
test， 或 使 用 IDEA 工 具 窗 口 Gradle projects 执 行 测试 。 














车 












































Gradle projects 
多 二 一 | 二 | 至 诗 | 只 | 区 
人 tdd-java-ch04-ship 
[Ca Tasks 
[3 build 
[3 build setup 
[3 documentation 
[shelp 
[3 other 
[a verification 
合 check 
合 clean 


[Dependencies 

















项 目 创建 完毕 后 ， 着 手 处 理 第 一 个 需求 。 


4.5.3 需求 1 


要 移动 军舰 ， 需 要 知道 它 当 前 的 位 置 ; 男 外 ， 还 需 知 道 军舰 面向 哪个 方向 : 北 、 南 、 东 还 是 
西 。 因 此 ， 第 一 个 需求 如 下 : 











| 给 定 军 般 的 起 始 位 置 (x,y) 以 及 它 面向 的 方向 (N、S、E 或 W)。 | 





处 理 这 个 需求 前 ， 先 看 一 下 可 使 用 的 辅助 类 。Point 类 存储 了 坐标 x 和 y， 其 构造 函数 如 下 : 


public Point (int x, int y) { 
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le n= 
te 
} 


还 有 枚 举 类 Direction， 它 定义 的 值 如 下 : 


public enum Direction { 
NORTH(0, 'N), 


EAST(1, 'E'), 
SOUTH (2 Sy 
WEST(3, ‘'W'), 
NONE(4, 'X'); 


} 
最 后 ， 还 有 Location 类 ， 其 构造 函数 将 前 述 两 个 类 的 对 象 作为 参数 : 


public Location(Point point, Direction direction) { 
tit Lt 
this.direction = direction; 





} 
知道 这 些 后 ， 为 第 一 个 需求 编写 测试 就 非常 容易 。 你 应 该 像 前 一 章 那 样 做 。 
请 尝试 自己 编写 规范 , 完成 后 再 将 其 与 本 书 提供 的 解决 方案 进行 比较 。 对 于 实现 规范 的 代码 ， 






































这 样 做 : 尝试 自己 编写 它们 完成 后 再 与 我 们 提供 的 解决 方案 进行 比较 。 


储 ; 




















1. 规范 
这 个 需求 的 规范 如 下 : 
@Test 


public class ShipSpec { 


public void whenInstantiatedThenLocationIsSet() { 
Location location = new Location( 
new Point (21, 13), Direction.NORTH); 
Ship ship = new Ship(location); 
assertEquals (ship.getLocation(), location); 


这 个 规范 很 简单 ， 我们 只 做 了 这 样 的 检查 : 传递 给 构造 函数 ship 的 Location 对 象 是 否 被 存 
能 和 否 通过 获取 男 数 getLocation 访 问 它 。 


注解 @Test 


RY 
a 使 用 TestNG 时 ， 在 类 级 指定 注解 eTest 后 , 无 需 再 指定 应 将 哪些 方法 视 为 测 


试 。 在 这 里 ， 所 有 的 公有 方 法 都 被 视 为 TestNG 测 试 。 
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2. 实现 


这 个 规范 的 实现 非常 简单 ， 只 需 将 构造 函数 的 参数 赋 给 变量 1ocation 即 可 : 
public class Ship { 


private final Location location; 
public Location getLocation() { 
return location; 


} 
public Ship(Location location) { 
this.location = location; 


} 


} 


完整 的 源 代码 可 在 仓库 tdd-java-ch04-ship 的 分 支 req01-location (https://bitbucket. 


org/vfarcic/tdd-java-ch04-ship/branch/req01-location ) 中 找到 。 
3. 重 构 


我 们 知道 ， 需 要 为 每 个 规范 实例 化 ship， 因 此 需要 重 构 规 范 类 ， 在 其 中 添加 一 个 用 
eBeforeMethod 注 解 的 方法 ， 如 下 所 示 


@Test 
public class ShipSpec { 


private Ship ship; 
private Location location; 


@BeforeMethod 
public void beforeTest() { 
Location location = new Location( 
new Point (21, 13), Direction.NORTH); 
ship = new Ship(location); 


} 


public void whenInstantiatedThenLocationIsSet() { 
// Location location = new Locationl( 
yh new Point (21, 13), Direction.NORTH); 
Lf Ship ship = new Ship(location); 
assertEquals (ship.getLocation(), location); 


我 们 没有 引入 任何 新 的 行为 ， 而 只 将 部 分 代码 移 到 了 用 eBeforeMethod 注 解 的 方法 中 ， 以 
免 编写 后 面 的 规范 时 重复 这 些 代码 。 这 样 ， 运 行 每 个 测试 时 ， 都 将 使 用 1ocation 为 参数 实例 化 
一 个 Ship 对 象 。 
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4.5.4 ”需求 2 
知道 军舰 在 什么 地 方 后 ， 下 面 尝试 移动 它 。 首 先 ， 我 们 应 该 让 它 能 够 前 进 和 后 退 。 





辅助 类 已 包含 方法 forward 和 backward， 它 们 实现 了 这 项 功能 : 





public boolean forward() { 


} 
1. 规范 
在 军舰 朝 北 的 情况 下 ,如果 我 们 向 前 移动 它 , 结果 将 如 何 呢 ?” 其 y 坐 标 将 减 1。 如 果 军 舰 面 向 
东 呢 ?其 x 坐标 应 加 1。 
面 对 这 样 的 情况 ， 你 的 第 一 反应 应 该 是 编写 两 个 类 似 于 下 面 的 规范 : 
public void givenNorthWhenMoveForwardThenYDecreases() { 


ship.moveForward(); 
assertEquals (ship.getLocation() .getPoint() .getY(), 12); 








} 


public void givenEastWhenMoveForwardThenxIncreases() { 
ship.getLocation().setDirection(Direction.EAST); 
ship.moveForward(); 
assertEquals (ship.getLocation() .getPoint() .getx(), 22); 
} 


如 果 这 样 做 ， 你 至 少 还 需 编写 两 个 规范 ， 它 们 分 别 与 军舰 朝 南 和 西 相关 。 

然而 ,不 应 这 样 编写 单元 测试 。 大 多 数 UT 新 手 都 会 落 入 这 样 的 陷阱 ， 即 指定 方法 的 结果 时 ， 
牵涉 到 它 使 用 的 方法 、 类 和 库 的 内 部 工作 原理 。 这 种 做 法 在 很 多 层面 上 都 存在 问题 。 

当前 规范 的 单元 中 包含 外 部 代码 时 ， 应 考虑 这 样 一 点 〈 至 少 在 这 里 应 该 如 此 )， 即 外 部 代码 
已 经 过 测试 。 我 们 知道 外 部 代码 没有 问题 ， 因 为 每 次 修改 代码 后 ， 我 们 都 运行 了 所 有 测试 。 














每 次 修改 实现 代码 后 都 再 次 运行 所 有 测试 。 
这 确保 对 代码 所 做 的 修改 不 会 带 来 任何 意外 的 副作用 。 
本 每 次 修改 实现 代码 后 ,都 应 运行 所 有 测试 。 最 理想 的 情况 是 ,测试 的 执行 速 
度 很 快 ， 且 开发 人 员 能 够 在 本 地 运行 。 将 代码 提交 给 版 本 控制 系统 后 ， 应 再 次 运 
行 所 有 测试 ， 确 认 代码 合并 没有 带 来 任何 问题 。 多 位 开发 人 员 协 作 开 发 代码 时 ， 
这 显得 尤其 重要 。 你 应 使 用 Jenkins、Hudson、Travind、Bamboo 和 Go-CD 等 持续 
集成 工具 从 仓库 获取 代码 、 对 其 进行 编译 并 运行 测试 。 
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这 种 做 法 存在 的 另 一 个 问题 是 ， 如 果 外 部 代码 发 生变 化 ,将 需要 修改 很 多 规范 ; 而 理想 情况 
下 ， 单 元 被 修改 时 ， 应 只 需 修改 与 之 直接 相关 的 规范 。 如 果 必 须 找 出 调用 了 该 单元 的 所 有 地 方 ， 
将 既 耗 时 又 容易 出 错 。 











对 于 前 面 的 需求 ， 要 为 其 编写 规范 ， 一 种 更 容易 、 更 快捷 、 更 好 的 方式 如 下 所 示 : 


public void whenMoveForwardThenForward() { 
Location expected = location.copy(); 
expected.forward(); 
ship.moveForward(); 


assertEquals (ship.getLocation(), expected); 
} 


由 于 Location 已 包含 方法 forward， 因 此 只 需 确 认 正 确 调用 了 这 个 方法 。 为 此 ， 我 们 创建 一 
个 新 的 Location 对 象 expected ， 调 用 其 方法 forward， 再 将 这 个 对 象 同 调用 方法 
moveForward 后 的 军舰 位 置 进 行 比 较 。 


请 注意 ,规范 不 仅 用 于 验证 代码 ,还 被 用 作 可 执行 的 文档 ,最 重要 的 是 ,它们 还 被 用 作 思 
和 设计 方式 。 前述 修 改 后 的 规范 更 清晰 地 指出 了 其 意图 : 应 在 Ship 类 中 创建 方法 moveForwardqd,， 
并 确保 这 个 方法 调用 了 location.forward。 

















2. 实现 
有 了 这 种 简短 而 明确 的 规范 后 ， 编 写实 现代 码 应 非常 容易 : 


public boolean moveForward() { 


return location.forward(); 


} 


3. 规范 





前 面 规 范 并 实现 了 前 进 功能 ， 后 退 功能 儿 乎 完全 相同 : 


public void whenMoveBackwardThenBackward() { 
Location expected = location.copy(); 
expected.backward(); 
ship.moveBackward (); 
assertEquals (ship.getLocation(), expected); 


} 

4. 实现 

与 规范 一 样 ， 后 退 功 能 的 实现 也 很 容易 : 
public boolean moveBackward() { 


return location.backward(); 


} 


这 个 需求 的 完整 源 代码 可 在 仓库 tagd- java-ch04-ship 的 分 支 req02-forward-backward 
( https://bitbucket.org/vfarcic/tdd-java-ch04-ship/branch/req02-forward-backward ) 中 找到 。 
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4.5.5 ”需求 3 
仅仅 前 后 移动 军舰 意义 不 大 ， 还 应 能 够 让 军舰 左 转 和 右 转 。 


| 实现 让 军舰 左 转 和 右 转 的 命令 (1 和 T )。 





实现 前 一 个 需求 后 , 这 个 需求 实现 起 来 应 非常 容易 , 因为 其 逻辑 完全 相同 。 辅 助 类 Location 
已 经 包含 实现 这 项 需求 的 方法 turnLeft 和 turnRight， 我 们 只 需 将 它们 集成 到 ship 类 中 即 可 。 


1. 规范 
基于 前 面 遵循 的 指导 方针 ， 可 这 样 编写 有 关 左 转 的 规范 : 


public void whenTurnLeftThenLeft() { 
Location expected = location.copy (); 
expected.turnLeft (); 
ship.turnLeft (); 
assertEquals (ship.getLocation(), expected); 


} 
2. 实现 
你 可 以 轻松 编写 让 这 个 规范 通过 的 代码 : 


public voidq turnLeft() { 
location.turnLeft (); 


} 
3. 规范 
右 转 应 该 与 左 转 几乎 完全 相同 : 


public void whenTurnRightThenRight() { 
Location expected = location.copy (); 
expected.turnRight (); 
ship.turnRight (); 
assertEquals (ship.getLocation(), expected); 





} 
4. 实现 
最 后 结束 这 个 需求 ， 实 现 右 转 规范 : 


public void turnRight() { 
location.turnRight (); 





} 


这 个 需求 的 完整 源 代码 可 在 仓库 taqd-java-ch04-ship 的 分 支 req03-left-right 
( https://bitbucket.org/vfarcic/tdd-java-ch04-ship/branch/req03-left-right ) 中 找到 。 








图 灵 社 区 会 员 yasenluobinh(yasenluobinhappy@163.com) 专 享 尊重 版 权 


4.5 开发 “ 须 控 军舰 ” 75 





4.5.6 需求 4 


前 面 所 做 的 一 切 都 非常 简单 ,因为 有 辅助 类 提供 了 所 有 功能 。 这 个 练习 旨 在 让 你 学 会 不 去 测 
试 最 终结 果 , 而 专注 于 当前 要 开发 的 单元 。 这 是 为 了 加 强 信任 ,因为 我 们 必须 信任 他 人 编写 的 代 
码 (辅助 类 )。 从 这 个 需求 开始 ， 你 将 必须 信任 自己 编写 的 代码 。 我 们 将 继续 前 面 的 做 法 : 编写 
规范 、 运 行 测试 并 发 现 它们 以 失败 告终 ; 再 编写 实现 、 运 行 测试 并 发 现 测试 通过 ; 最 后 ， 对 我 们 
认为 存在 改进 空间 的 代码 进行 重 构 。 同 时 , 继续 秉承 这 样 的 思路 ， 即 对 单元 (方法 ) 进行 测试 时 ， 
不 要 过 多 考虑 它 将 调用 的 方法 或 类 。 


实现 各 个 命令 ( 前进、 后 退 、 左 转 和 右 转 ) 后 ， 下 面 结合 使 用 它们 。 我 们 应 创建 一 个 方法 ， 
它 接受 一 个 字符 串 作为 参数 ， 其 中 可 包含 任意 数量 的 命令 。 每 个 命令 都 用 一 个 字符 表示 : f 瑟 示 
前 进 、b 表 示 后 退 、! 表 示 左 转 、r 表 示 右 转 。 


| 军舰 可 接收 一 个 包含 命令 的 字符 事 (例如 ，1rfb 相 当 于 左 转 、 右 转 、 前 进 4 













































































再 后 退 )。 


1. 规范 
先 看 只 包含 字符 f ( 前进 ) 的 命令 参数 : 


public void whenReceiveCommandsFThenForward() { 
Location expected = location.copy(); 
expected.forward(); 
ship.receiveCommands ("f"); 
assertEquals (ship.getLocation(), expected); 





} 




















这 个 规范 几乎 与 whenMoveForwardThenForward 相 同 ， 只 是 其 中 调用 的 是 方法 ship. 


receiveCommands ("f")method,。 
2. 实现 
应 编写 尽 可 能 简单 的 代码 ， 只 要 让 规范 能 够 通过 即 可 ， 这 样 做 的 重要 性 如 前 所 述 。 














应 编写 尽 可 能 简单 的 代码 ， 只 要 让 测试 能 够 通过 即 可 。 这 可 确保 设计 越 来 
y 越 清晰 ， 并 避免 包含 多 余 功 能 。 
SS 这 里 的 理念 是 ， 实 现 越 简单 ， 产 品 越 好 ， 维 护 也 越 容易 。 这 种 理念 遵循 了 
KISS 原 则 ， 该 原则 指出 ， 对 大 多 数 系 统 而 言 ， 保 桂 简单 而 不 是 复杂 化 的 效果 最 
好 。 因 此 设计 的 主要 目标 是 简约 ， 必 须 避 免 不 必 要 的 复杂 性 。 








现在 正 是 应 用 这 条 规则 的 大 好 时 机 。 你 可 能 倾向 于 编写 如 下 代码 : 


public void receiveCommandqs (String commands) { 














图 灵 社 区 会 员 yasenluobinh(yasenluobinhappy@163.com) 专 享 尊重 版 权 








76 第 4 章 单元 测试 专注 于 当下 而 非 过 往 





if (commands.charAt (0) == 'f') { 
moveForward(); 


} 


这 个 代码 示例 中 ,你 检查 第 一 个 字符 是 否 是 :， 如 果 是 就 调用 方法 moveForward。 可 使 用 的 
其 他 变种 还 有 很 多 ， 但 如 果 坚 持 简约 原则 ， 下 面 的 解决 方案 更 好 : 












































public void receiveCommandqs (String command) { 
moveForward(); 


} 

这 上段 代码 能 够 让 前 述 规范 得 以 通过 , 且 最 简单 、 最 简短 。 最 后 的 代码 可 能 与 第 一 个 版 本 更 接 
近 ; 随 着 情况 越 来 越 复杂 ,我 们 还 可 能 使 用 循环 或 设计 其 他 解决 方案 。 但 目前 而 言 , 我 们 每 次 专 
注 于 一 个 规范 ， 并 力图 让 代码 尽 可 能 简单 。 我 们 力图 只 专注 于 手头 的 任务 ， 以 理 清 思路 。 

为 简洁 起 见 ， 这 里 不 再 演示 如 何 处 理 其 他 命令 (b、1 和 *， 你 可 自己 规范 并 实现 )， 而 直接 
跳 到 这 项 需求 中 的 最 后 一 个 规范 。 

3. 规范 

能 够 处 理 单个 命令 (不管 这 个 命令 是 什么 ) 后 ,下面 添加 发 送 命令 字符 串 的 选项 。 相 应 规范 
如 下 : 



























































public void whenReceiveCommandsThenAllAreExecuted() { 
Location expected = location.copy (); 
expected.turnRight (); 
expected.forward(); 
expected.turnLeft (); 
expected.backward(); 
ship.receiveCommands ("rflb"); 
assertEquals (ship.getLocation(), expected); 


} 

这 个 规范 有 点 长 , 但 依然 不 太 复 杂 。 我 们 传递 命令 字符 串 rf1p ( 右 转 、 前 进 、 左 转 和 后 退 )， 
并 期 望 Location 发 生 相应 变化 。 与 以 前 一 样 ， 我 们 没有 验证 最 终结 果 ( 检查 坐标 是 否 发 生 相 应 变 
化 )， 而 检查 是 否 正确 调用 了 辅助 类 的 方法 。 



































4. 实现 
实现 代码 可 能 如 下 所 示 : 


public voidq receiveCommands (String commands) { 


for (char command : commands.toCharArray ()) { 
switch(command) { 
case 'f': 
moveForward(); 
break; 
case 'b': 
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moveBackward () ; 
break; 

Case '1': 
turnLeft (); 
break; 

Case 'r': 
turnRight (); 
break; 





} 


如 果 你 尝试 自己 编写 规范 和 实现 , 并 遵循 简约 规则 , 很 可 能 重 构 多 次 后 才 得 到 最 终 的 解决 方 
案 。 简 约 是 关键 ， 而 重 构 通常 是 必须 的 。 重 构 时 别 忘 了 ， 所 有 规范 都 必须 在 任何 时 候 都 能 通过 。 









































仅 当 所 有 测试 都 通过 后 才 重 构 
RN] 这 样 做 的 优点 如 下 : 重 构 是 安全 的 。 
如 果 所 有 可 能 受 影响 的 实现 代码 都 有 测试 , 且 所 有 测试 都 通过 ,那么 重 构 将 
是 相对 安全 的 。 大 多 数 情况 下 不 需要 添加 新 的 测试 , 而 只 需 对 既 有 测试 做 细微 的 
修改 即 可 。 重 构 的 预期 结果 是 ， 在 修改 代码 之 前 和 之 后 ， 所 有 测试 都 能 通过 。 





这 项 需求 的 完整 源 代 码 可 在 仓库 tdd-java-ch04-ship 的 分 支 req04-commands 
( https://bitbucket.org/vfarcic/tdd-java-ch04-ship/branch/req04-commands ) 中 找到 。 





4.5.7 需求 5 

与 其 他 星球 一 样 ， 地 球 也 是 圆 的 。 用 地 图 表示 地 球 时 ， 到 达 地 图 的 边缘 后 ， 将 进入 另 一 边 。 
例如 ， 如 果 我 们 向 东 移 动 到 太平 洋 的 最 远 端 , 将 到 达 地 图 的 西边 ,并 离 美洲 越 来 越 近 。 另 外 , 为 
让 移动 更 容易 ， 可 将 地 图 定义 为 网 格 。 这 个 网 格 有 长 度 和 高 度 ， 分 别 对 应 于 X 轴 和 Y 轴 ; 同时 ， 
这 个 网 格 有 最 大 的 X 值 和 Y 值 。 


| 实现 从 网 格 的 一 边 转 到 另 一 边 。 ] 


1. 规范 

首先 , 我 们 可 以 将 x 坐标 和 Y 坐 标 为 最 大 值 的 Pl1anet 对 象 传 递 给 ship 构 造 函 数 。 所 幸 Planet 
也 是 一 个 辅助 类 ,已 经 创建 好 并 经 过 了 测试 。 我 们 只 需 实例 化 这 个 类 ， 并 将 得 到 的 对 象 传递 给 
Ship 构 造 函 数 : 




















public void whenInstantiatedThenPlanetIsStored() { 
Point max = new Point (50, 50); 
Planet planet = new Planet (max); 


图 灵 社 区 会 员 yasenluobinh(yasenluobinhappy@163.com) 专 享 尊重 版 权 








78 第 4 章 单元 测试 专注 于 当下 而 非 过 往 





ship = new Ship(location, planet); 
assertEquals (ship.getPlanet (), planet); 
二 


我 们 将 星球 的 大 小 定义 为 50 x 50,， 并 使 用 这 种 大 小 实例 化 Planet 类 ,再 将 生成 的 对 象 传递 
给 ship 构 造 函 数 。 你 可 能 注意 到 ， 这 个 构造 函数 接受 一 个 额外 的 测试 ， 而 当前 它 只 接受 一 个 
Location 对 象 作为 参数 。 为 实现 这 个 规范 ， 必 须 让 这 个 构造 函数 同时 将 一 个 Planet 对 象 作为 


如 何 实 现 这 个 规范 ， 同 时 又 不 破坏 任何 既 有 规范 呢 ? 
2. 实现 
我 们 采用 自 下 而 上 的 方法 。 规 范 末尾 的 断言 要 求 有 一 个 planet 获 取 方 法 : 


private Planet planet; 
public Planet getPlanet() { 
return planet; 


} 

接 下 来 ， 需 要 让 构造 函数 将 一 个 Planet 对 象 作为 第 二 个 参数 ， 并 将 其 赋 给 刚才 添加 的 变量 
planet。 你 首先 想到 的 可 能 是 在 既 有 的 构造 函数 中 添加 这 个 参数 ， 但 这 将 破坏 很 多 既 有 规范 ， 
因为 它们 使 用 只 有 一 个 参数 的 构造 函数 。 因 此 我 们 别 无 选择 ， 只 能 再 添加 一 个 构造 函数 : 











public Ship(Location location) { 
this.location = location; 

} 

public Ship(Location location, Planet planet) { 
this.location = location; 
this.planet = planet; 

} 


运行 所 有 规范 ( 测试 )， 并 确认 它们 都 通过 。 

3. 重 构 

基于 我 们 制定 的 规范 ,必须 创建 第 二 个 构造 函数 。 因 为 如 果 修 改 既 有 的 构造 函数 ,将 破坏 既 
有 测试 。 然而， 鉴于 现在 所 有 测试 都 通过 ,我 们 可 以 做 些 重 构 ， 以 便 能 够 将 只 接受 一 个 参数 的 构 
造 函 数 删除 。 规 范 类 已 包含 一 个 beforeTest 方 法 ， 它 将 在 每 个 测试 之 前 运行 。 对 于 刚才 制定 的 
规范 ， 我 们 可 以 将 其 中 除 断 言 外 的 其 他 所 有 代码 都 移 到 这 个 beforeTest 方 法 中 : 























public class ShipSpec { 
private Planet planet; 
@BeforeMethod 
public void peforeTest () { 


Point max = new Point (50, 50); 
location = new Location(new Point (21, 13), Direction.NORTH); 
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planet = new Planet (max) 
Ax ship = new Ship(location); 
ship = new Ship(location, planet); 
} 
public void whenInstantiatedThenPlanetIsStored() { 


// Point max = new Point (50, 50); 

/4 Planet planet = new Planet (max); 

/i ship = new Ship(location, planet); 
assertEquals (ship.getPlanet (), planet); 








这 样 的 修改 后 ,将 不 再 使 用 只 接受 一 个 参数 的 Ship 构 造 函 数 。 通 过 运行 所 有 规范 可 确认 ， 
种 修改 是 可 行 的 。 


现在 ,我 们 没有 使 用 接受 一 个 参数 的 构造 函数 ， 因 此 可 将 其 从 实现 类 中 删除 : 


public class Ship { 











// public Ship(Location location) { 


// this.location = location; 
7 } 


public Ship(Location location, Planet planet) { 
this.location = location; 
this.planet = planet; 


} 


这 样 重 构 后 ， 所 有 规范 都 通过 了 。 这 种 重 构 没有 改变 任何 既 有 功能 ， 也 没有 破坏 任何 东西 ， 
且 整 个 重 构 过 程 很 快 就 完成 了 。 


下 面 处 理 回转 本 身 。 
4. 规范 


与 前 面 一 样 ， 辅 助 类 提供 了 我 们 需要 的 所 有 功能 。 前 面 使 用 的 都 是 不 接受 任何 参数 的 方法 
Location.forward， 但 为 实现 回转 ， 必 须 使 用 该 方法 的 另 一 个 重 载 版 本 Location. 
forward (Point max)， 它 在 到 达 网 格 边缘 时 将 军舰 转 到 另 一 边 。 前 一 个 规范 中 ， 我 们 确保 使 
用 Point 对 象 max 实 例 化 一 个 Planet 对 象 ， 并 将 其 \ 仿 递 给 会 Ship 构 造 函 数 ; 而 这 里 的 任务 是 ， 确 
保 前 进 时 根据 max 确 定 当 前 位 置 。 为 此 ， 可 这 样 编写 这 个 规范 : 


/* 考虑 到 本 书 版 式 ， 我 们 将 这 个 方法 的 名 称 缩短 了 。 这 个 测试 引 在 检查 军舰 跨越 网 格 右边 缘 后 的 行为 。*/ 
public void overpassEastBoundary() { 

location.setDirection(Direction.EAST); 

Jocation.getPoint().setX(planet .getMax() .getX()); 

ship.receiveCommands ("f"); 

assertEquals (location.getX(), 1); 
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5. 实现 


此 , 你 应 该 习惯 了 每 次 专注 于 一 个 单元 ， 并 信任 之 前 实现 的 单元 都 像 期 望 的 那样 工作 。 这 
| ， 我 们 只 需 确 保 调 用 方法 1ocation.forwaraq 时 使 用 了 最 大 坐标 : 
public boolean moveForward() { 


// return location.forward(); 
return location.forward(planet .getMax()); 





} 
对 于 方法 backward， 规 范 和 实现 与 此 相同 。 为 简洁 起 见 ， 本 书 没有 列 出 这 些 代码 ,但 你 可 在 
源 代码 中 找到 它们 。 


这 个 需求 的 完整 源 代码 可 在 仓库 tad-java-ch04-ship 的 分 支 req05-wrap( https://bitbucket. 
org/vfarcic/tdd-java-ch04-ship/branch/req05-wrap ) 中 找到 。 

















4.5.8 ”需求 6 
我 们 就 要 完成 了 ， 这 是 最 后 一 项 需求 。 
虽然 地 球 表 面 的 很 大 一 部 分 ( 大 约 70% ) 都 被 水 覆盖 ,但 还 有 一 些 大 洲 和 岛屿 ， 它 们 对 遥控 








军舰 来 说 就 是 障碍 。 我 们 需要 能 够 检测 接着 移动 军舰 是 否 会 撞 上 这 些 障碍 ,如 果 会 ,就 应 放弃 这 
样 的 移动 ， 让 军舰 留 在 原 地 并 报告 将 遇 到 的 障碍 。 











KW 每 次 移动 前 都 进行 障碍 检测 。 如果 执 行 指定 的 命令 将 遇 到 障碍 , 军舰 应 放弃 
移动 ， 留 在 原 地 并 报告 遇 到 的 障碍 。 


这 个 规范 及 其 实现 与 前 面 所 做 的 很 像 ， 这 些 工作 留 给 你 自己 去 完成 。 
下 面 儿 个 小 提示 可 能 会 对 你 有 所 帮助 : 


口 Planet 类 有 一 个 构造 函数 将 障碍 列表 作为 参数 。 每 个 障碍 都 是 一 个 Point 实 例 。 

口 方法 Location.forward 和 Location.backward 都 有 将 障碍 列表 作为 参数 的 重 载 版 本 ， 
它们 在 移动 成 功 时 返回 true， 在 移动 失败 时 返回 false。 你 可 使 用 这 个 返回 的 布尔 值 创 
建 方 法 ship .receiveCommangds 所 需 的 状态 报告 

口 方法 receiveCommands 应 返回 一 个 字符 串 ， 以 指出 每 个 命令 的 状态 。 例 如 ， 你 可 使 用 0o 

表示 OK， 用 x 表示 失败 ( 例如，OOXO 表 示 OK、OK、 失 败 和 OK )。 


这 个 需求 的 完整 源 代码 可 在 仓库 tqd-java-ch04-ship 的 分 支 req06-obstacles 
( https://bitbucket.org/vfarcic/tdd-java-ch04-ship/branch/req06-obstacles ) 中 找到 。 
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4.6 小结 











本 章 中 ， 我们 使 用 了 测试 框架 TestrNG。 与 使 用 JNnit 时 相 比 ， 没 有 太 多 不 同 ， 因 为 我 们 没有 
使 用 TestNG 的 任何 高 级 功能 ， 如 数据 提供 器 、 工 厂 等 。 在 TDD 中 , 我 们 可 能 根本 不 需要 使 用 这 些 
高 级 功能 。 














请 访问 http://testng.org/， 对 TestNG 进 行 探索 ， 再 决定 哪个 框架 最 能 满足 你 的 需求 。 


























本 章 的 主要 目标 是 介绍 如 何 每 次 专注 于 一 个 单元 。 我们 编写 了 大 量 辅助 类 , 并 尽量 忽略 其 内 
部 工作 原理 。 很 多 情况 下 , 我们 编写 规范 时 都 没有 验证 最 终结 果 是 否 正确 ,而 检查 待 实现 的 方法 
是 否 调用 了 辅助 类 的 正确 方法 。 实 际 工作 中 ,你 将 与 其 他 小 组 成 员 协 作 开 发 项 目 ， 因 此 学 会 如 何 
专注 于 分 配给 你 的 任务 并 相信 他 人 开发 的 代码 像 预 期 的 那样 工作 至 关 重 要 。 对 于 第 三 方 库 , 也 应 
采取 同样 的 态度 。 如 果 对 我 们 调用 的 内 部 处 理 可 能 出 现 的 情况 都 进行 测试 , 代价 实在 太 高 , 况且 
还 有 其 他 类 型 的 测试 会 尝试 覆盖 这 些 可 能 性 。 进 行 单元 测试 时 ， 应 专注 于 当前 的 单元 。 


至 此 , 你 对 在 TDD 中 如 何 有 效 利用 单元 测试 有 更 深入 的 认识 ,下面 该 深入 探索 TDD 提 供 的 其 
他 优点 了 。 具 体 地 说 ， 我 们 将 探索 如 何 将 应 用 程序 设计 得 更 好 。 
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设计 不 佳 


设计 一 一 难以 测试 说 明 








“大 道 至 简 , 





列 奥 纳 多 





. 达 。 芬 厅 

















以 前 ,软件 行业 都 专注 于 快速 开发 ,心里 只 有 成 本 和 时 间 ， 质量 只 是 次 要 目 
员 存 在 误区 ， 认 为 客户 对 此 漠不关心 。 





标 。 因 为 开发 人 





现在 , 随 着 各 种 平台 和 设备 的 联系 日 益 紧 密 , 质量 成 了 客户 需求 的 重 中 之 重 。 卓越 的 应 用 程 
序 都 提供 卓越 的 服务 且 响 应 时 间 合 理 ， 即 便 大 量 用 户 同 时 发 出 大 量 请 求 亦 是 如 此 。 











质量 卓越 的 应 用 程序 都 设计 良好 ， 而 良好 的 设计 意味 着 可 伸缩 性 、 安 全 性 、 
其 他 优良 品质 。 


可 维护 性 和 众多 





本 章 以 传统 方法 和 TDD 方 法 开发 同一 款 应 用 程序 , 以 此 探索 TDD 如 何 引 导 开 发 人 员 走 向 通 往 


良好 设计 和 最 佳 实践 的 道路 。 
本 章 涵盖 如 下 主题 ; 

口 为 何 要 关心 设计 ; 

口 设计 方面 的 考量 ; 

口 传统 的 开发 流程 ; 

口 TDD 方 法 ; 

口 Hamcrest。 








5.1 为 何 要 关心 设计 

















无 论 你 是 专家 还 是 初学 者 ,都 会 在 编码 领域 遇 到 看 起 来 很 怪异 的 代码 , 进而 感觉 有 什么 地 方 
不 对 。 偶尔 甚至 会 心 生 疑 惑 , 前 一 位 程序 员 为 何 要 以 如 此 糟糕 的 方式 实现 方法 或 类 ? 这 是 因为 每 
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种 功能 都 有 很 多 不 同 的 实现 方式 ， 而 每 种 方式 都 是 独一无二 的 。 在 如 此 之 多 的 实现 方式 中 , 到 底 
哪 种 是 最 佳 的 呢 ? 答案 是 , 不管 白 猫 还 是 黑 猫 ， 能 抓 到 老鼠 的 就 是 好 猫 。 然 而 ， 寻 找 更 佳 的 解决 
方案 时 ， 确 实 有 一 些 因 素 需要 考虑 。 此 时 ， 设 计 就 显得 特别 重要 。 





























设计 原则 

TDD 倡 导 程 序 员 遵守 一 些 让 代码 更 清晰 、 更 易 读 的 原则 和 良好 实践 , 从 而 确保 代码 易于 理解 
并 能 安全 地 修改 。 下 面 看 一 些 基本 的 软件 设计 原则 。 

1. 你 不 会 需要 它 


YAGNI 是 设计 原则 You Ain't Gonna Need It( 你 不 会 需要 它 ) 的 首 字母 缩写 ， 旨 在 消除 所 有 
宛 余 代 码 ， 并 专注 于 当前 而 不 是 未 来 的 功能 。 代 码 越 少 ， 需 要 维护 的 代码 就 越 少 ， 同 时 引入 bug 
的 可 能 性 也 越 小 。 


有 关 YAGNI 的 更 详细 信息 ， 请 参阅 Martin Fowler 撰 写 的 相关 文章 ， 网 址 为 http://martinfowler. 
com/bliki/Yagni.html。 


2. 不 要 自我 重复 


不 要 自我 重复 ( DRY ) 原则 基于 的 理念 是 , 重用 而 不 是 复制 以 前 编写 的 代码 。 这 样 做 的 好 处 
是 , 需要 维护 的 代码 更 少 ,并 确信 使 用 的 代码 是 可 行 的 一 一 这 是 天 大 的 好 事 。 另 外 ,这 还 有 助 于 
在 代码 中 发 现 新 的 抽象 层级 。 


有 关 这 个 设计 原则 的 更 详细 信息 ， 请 参阅 http://en.wikipedia.org/wiki/Don%27t_repeat_ 
yourself。 


3. 保持 简单 


这 个 原则 是 Kelly Johnson 提 出 的 ， 其 首 字母 缩写 令 人 迷惑 。 这 个 原则 指出 ， 越 简单 的 东西 越 
能 实现 其 功能 。 


有 关 这 条 原则 背后 的 故事 ， 请 参阅 http:/en.wikipedia.org/wikiKISS_principle。 
4. 奥 卡 姆 剃刀 原理 


奥 卡 姆 剃刀 原理 是 一 个 哲学 原则 ， 而 非 软 件 工程 原则 , 但 它 依然 适用 于 我 们 从 事 的 工作 。 这 
个 原则 与 前 一 个 原则 极其 相似 ， 其 主要 推论 如 下 : 











































































































“如 果 你 有 两 个 或 多 个 类 似 的 解决 方案 ， 选 择 最 简单 的 。” 


一 一 奥 卡 姆 的 威廉 
有 关 奥 卡 姆 剃刀 原理 的 详细 信息 ， 请 参阅 http:/en.wikipedia.org/wikiOccam9%27s_ Tazor。 
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5. SOLID 


SOLID 是 Robert C. Martin 发 明 的 一 个 首 字 母 缩写 ， 涵 盖 5 个 面向 对 象 编程 的 基本 原则 。 通 过 
遵守 这 5 个 原则 ， 开 发 人 员 更 有 可 能 打造 卓越 、 持 久 和 易于 维护 的 应 用 程序 : 


口 单一 职责 原则 : 一 个 类 应 该 只 有 一 个 导致 它 需要 修改 的 原因 。 
口 开 - 闭 原则 : 类 应 该 对 扩展 是 开放 的 ， 对 修改 是 封闭 的 。 这 个 原则 最 初 由 Bertrand Meyer 















































提出 。 
口 里 氏 蔡 换 原 则 : 这 个 原则 是 Barbara Liskov 提 出 的 ， 她 指出 ， 类 应 该 能 够 被 扩展 它 的 类 
替换 。 





口 接口 分 离 原 则 : 提供 多 个 具体 接口 胜 过 提供 单个 通用 接口 。 
D 依赖 倒转 原则 : 类 应 依赖 于 抽象 而 不 是 实现 ， 这 意味 着 类 依赖 必须 专注 于 做 什么 而 不 是 
如 何 做 。 


有 关 SOLID 和 其 他 相关 原则 的 更 详细 信息 ， 请 参阅 http://butunclebob.com/ArticleS.UncleBob. 
PrinciplesOfOod。 


这 里 的 前 4 个 原则 是 TDD 思 维 的 核心 ， 因 为 它们 旨 在 简化 代码 ， 而 最 后 一 个 原则 专注 于 类 的 
编写 和 依赖 关系 。 


无 论 在 测试 驱动 开发 还 是 非 测试 驱动 开发 中 , 这 些 原则 都 适用 也 必须 遵守 ,因为 它们 让 代码 
更 容易 维护 ， 还 将 带 来 其 他 好 人 处。 有关 如 何 正 确 应 用 这 些 原 则 可 写 部 专著 ,这 里 没有 时 间 探 讨 ， 
但 建议 你 对 它们 做 更 深入 的 研究 。 


在 本 章 中 , 你 会 看 到 TDD 将 引导 开发 人 员 毫 不 费力 地 应 用 这 里 介绍 的 一 些 原则 。 我 们 将 使 用 
TDD 和 非 TDD 方 法 实现 著名 游戏 Connect4 的 小 型 版 本 ， 但 麻雀 虽 小 ,五 脏 俱全 。 请 注意 ，Gradle 
项 目 创建 等 重复 部 分 与 本 章 目标 无 关 ， 故 省 略 。 







































































5.2 Connect4 


Connect4 是 一 款 流 行 的 桌面 游戏 ， 其 规则 少 而 简单 ， 玩 起 来 很 容易 。 











Connec 乌 是 一 款 两 人 玩 的 连接 游戏 。 玩 家 首先 选择 颜色 ， 然 后 轮流 将 碟 片 放 
入 7 列 6 行 的 网 格 中 。 碟 片 重 直 下 落 , 停留 在 当前 列 中 下 一 个 未 占据 的 位 置 。 玩 家 
Ka 的 目标 是 抢 在 对 手 前 将 自 人 排 成 水 平 线 、 重 直线 或 对 角 线 。 
有 关 这 款 游戏 的 更 详细 信息 ， 请 参阅 维基 百科 ( http://en.wikipedia.org/wiki/ 
Connect Four )。 
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为 编写 Connect4 的 两 个 实现 ,下 面 以 需求 的 方式 转录 这 个 游戏 的 规则 。 这 两 个 开发 过 程 都 以 
这 些 需 求 为 起 点 ， 完 成 后 我 们 将 对 代码 做 些 解释 ， 并 对 这 两 个 实现 进行 比较 : 


(1) 棋盘 为 7 列 6 行 ， 所 有 格子 都 是 空 的 。 

(2) 玩家 从 列 顶 放 入 碟 片 。 如 果 整 列 为 空 ， 放 和 人 的 矶 片 将 落 到 底部 。 在 特定 列 中 ， 后 放 入 的 
碟 片 将 至 在 前 面 放 入 的 碟 片 之 上 。 

(3) 这 是 一 款 两 人 玩 的 游戏 ， 每 位 玩家 的 矶 片 用 一 种 颜色 表示 : 一 位 玩家 为 红色 (中 ' )， 另 一 
位 玩家 为 绿色 〈'G' )。 玩 家 轮流 放 入 碟 片 ， 每 次 放 和 人 一个。 

(4) 我 们 要 在 玩家 放 人 矶 片 或 发 生 错误 时 提供 反馈 : 每 当 玩家 放 入 碟 片 后 ， 都 使 用 输出 指出 
棋盘 状态 。 

(5) 无 法 再 放 入 碟 片 时 游戏 结束 ， 结 果 为 平局 。 

(6) 玩家 放 和 碟 片 后 ， 如 果 将 其 3 个 以 上 矶 片 连 成 垂直 线 ， 该 玩家 将 获胜 。 

(7) 玩家 放 入 碟 片 后 ， 如 果 将 其 3 个 以 上 碟 片 连 成 水 平 线 ， 该 玩家 将 获胜 。 

(8) 玩家 放 入 碟 片 后 ， 如 果 将 其 3 个 以 上 碟 片 连 成 对 角 线 ， 该 玩家 将 获胜 。 
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这 是 传统 的 开发 方法 ,专注 于 解决 问题 而 不 是 测试 。 有 些 人 和 公司 对 自动 化 测试 的 价值 置 若 
回 闻 ， 而 依赖 用 户 执行 用 户 验收 测试 。 


这 种 用 户 验 收 测试 在 受 控 环境 ( 最 好 与 生产 环境 完全 相同 ) 中 重 现 真实 场景 ， 让 用 户 执行 大 
量 不 同 的 任务 ， 以 验证 应 用 程序 的 正确 性 。 如 果 有 操作 失败 ， 代 码 就 是 不 可 接受 的 ， 因 为 它们 破 
坏 了 某 些 功能 ， 或 不 像 预期 的 那样 工作 。 

另外 , 很 多 公司 还 将 单元 测试 作为 一 种 执行 早期 回归 检查 的 手段 。 这 些 单元 测试 是 在 开发 结 
束 后 编写 的 ， 旨 在 覆盖 尽 可 能 多 的 代码 。 最 后 ， 执 行 代码 覆盖 分 析 ， 以 确定 这 些 单元 测试 覆盖 了 
哪些 代码 ; 代码 覆盖 率 越 高 ， 说 明 交 付 的 软件 质量 越 好 。 

下 面 使 用 这 种 方法 实现 Connect4。 每 个 需求 都 列 出 了 与 之 相关 的 代码 。 这 些 代码 不 是 以 增 量 
方式 编写 的 ， 因 此 有 些 代码 片段 可 能 包含 与 当前 需求 无 关 的 代码 行 。 


















































5.3.1 需求 1 
下 面 先 看 第 一 个 需求 。 


| 棋盘 为 7 列 6 行 ， 且 整个 棋盘 都 是 空 的 。 | 
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这 个 需求 的 实现 非常 简单 。 我 们 只 需 定义 “ 空 ”的 表示 方式 ， 并 创建 存储 游戏 数据 的 数据 结 
构 即 可 。 注 意 ， 这 里 还 定义 了 玩家 使 用 的 颜色 : 





public class Connect4 { 
public enum Color { 
RED('R'), GREEN('G'), EMPTY(' '); 
private final char value; 
Color(char value) { this.value = value; } 
@Override 
DUBLLTOG OtELNgG.. toOString() ®t 
return String.valueOf (value); 
} 
} 
public static final int COLUMNS = 7; 
public static final int ROWS = 6; 
private Color[][] board = new Color [COLUMNS] [ROWS]; 
public Connect4() { 
for (Color[] column : board) { 


Arrays.fill(column, Color.EMPTY); 
} 


5.3.2 需求 2 


第 二 个 需求 开始 实现 游戏 逻辑 。 


玩家 从 列 顶 放 入 碟 片 。 如 果 整 列 都 是 空 的 ， 放 入 的 碟 片 将 落 到 底部 。 在 特定 
列 中 ， 后 放 入 的 碟 片 将 登 在 前 面 放 入 的 碟 片 之 上 。 


这 部 分 需要 考虑 棋盘 的 边界 ， 还 需 标 出 哪些 位 置 被 占据 (使 用 color .RED 指 出 )。 最后， 我 
们 创建 了 第 一 个 私有 方法 ， 这 是 一 个 辅助 方法 ,计算 在 给 定 列 放 入 多 少 个 碟 片 : 














public voidq putDisc(int column) { 
if (column > 0 && column <= COLUMNS) { 
int numOfDiscs = 
getNumberOfDiscsInColumn (column - 1); 
if (numOfDiscs < ROWS) { 
board[column - 1] [numOfDiscs] = 
人 QI RED’; 
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private int getNumberOfDiscsInColumn (int column) { 
if (column >= 0 && column < COLUMNS) { 


int row; 
for (row = 0; row < ROWS; row++) { 
if (Color.EMPTY == board[column] [row]) { 


return row; 
} 
} 


return row; 


} 
return -1; 
5.3.3 需求 3 
这 个 需求 引入 了 更 多 游戏 逻辑 。 


这 是 一 款 两 人 玩 的 游戏 , 每 位 玩家 的 碟 片 用 一 种 颜色 表示 : 一 位 玩家 为 红色 
~> ('R')， 另 一 位 玩家 为 绿色 ('G' )。 玩 家 轮流 放 入 碟 片 ， 每 次 放 入 一 个 。 国 国 





我 们 需要 保存 当前 玩家 ， 以 判断 接 下 来 轮 到 哪个 玩家 。 还 需要 一 个 切换 玩家 的 函数 ， 以 实现 
轮流 逻辑 。 函 数 putDisc 中 ， 添 加 一 些 与 该 需求 相关 的 代码 。 具 体 地 说 , 将 相应 的 棋盘 位 置 分 配给 
当前 玩家 ， 并 根据 游戏 规则 切换 玩家 : 





private Color currentPlayer = Color.RED; 


private void SwitchPlayezr() { 


if (Color.RED == currentPlayer) 
currentPlayer = Color .GREEN; 
} else { 


currentPlayer = Color.RED; 
} 
} 


public void putDisc(int column) { 
if (column > 0 && column <= COLUMNS) { 
int numOfDiscs = 
getNumberOfDiscsInColumn (column - 1); 
if (numOfDiscs < ROWS) { 
board[column - 1] [numofDiscs] = 
currentpPlayer; 
switchPlayer (); 
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5.3.4 需求 4 
为 使 用 户 知道 游戏 当前 状态 ， 需 要 添加 一 些 输出 。 





我 们 要 在 玩家 放 入 碟 片 或 发 生 错 误 时 提供 反馈 : 每 当 玩家 放 入 碟 片 后 , 都 使 
一 用 输出 指出 棋盘 状态 。 


需求 没有 指定 输出 通道 。 出 于 简化 考虑 ,我 们 决定 使 用 系统 标准 输出 以 指出 发 生 的 事件 。 执 
行 操作 的 每 个 方法 都 添加 了 几 行 提供 输出 的 代码 ， 让 用 户 知道 游戏 的 当前 状态 : 





private static final String DELIMITER = "|"; 


private void switchplayer() { 


if (Color.RED == currentPlayer) { 
currentplayer = Color.GREEN; 
} else { 


currentPlayer = Color .RED; 

} 

System.out.println("Current turn: " + 
currentPlayer); 


} 


public void printBoard() { 
for (int row = ROWS - 1; row >= 0; --row) { 
StringJoiner stringJoiner = 
new StringJoiner (DELIMITER, 
DELIMITER, 
DELIMITER); 
for (jint col = 07 G0 < CODUMNS7 ++G0l) { 
stringJoiner 
.add (board[col] [row] .toString()); 
} 
System.out .println( 
stringJoiner.toString()); 


} 


public voidq putDisc(int column) { 
if (column > 0 && column <= COLUMNS) { 
int numOfDiscs = 
getNumberOfDiscsInColumn (column - 1); 
if (numOfDiscs < ROWS) { 
board[column - 1] [numofDiscs] = 
currentpPlayer; 
printBoard(); 
switchPplayer () ; 
} else { 
System.out .println (numOfDiscs); 
System.out .println("There's no room " + 
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"for a new disc in this column"); 
printBoard(); 
} 
} else { 
System.out.println("Column out of bounds"); 
printBoard(); 


5.3.5 需求 5 
第 一 个 游戏 结束 条 件 。 


| 全 无 法 再 放 入 碟 片 时 游戏 结束 ， 结 果 为 平局 。 


下 面 的 代码 是 一 种 可 能 的 实现 : 





Ri 














public boolean isFinished() { 
int numOofDiscs = 0; 
for (int col = 0; col < COLUMNS; ++col) { 
numOfDiscs += 
getNumberOfDiscsInColumn (col); 





if (numOfDiscs >= COLUMNS * ROWS) { 
System.out .println("It's a draw"); 
return true; 

} 


return false; 


5.3.6 需求 6 
第 一 个 获胜 条 件 。 





| 玩家 放 入 碟 片 后 ， 如 果 将 其 3 个 以 上 碟 片 连 成 重 直 线 ， 该 玩家 将 获胜 。 


私有 方法 checkwinconaition 实 现 了 这 条 规则 ， 它 检查 最 后 放 人 的 矶 片 会 否 让 玩家 获胜 : 





private Color winner; 


public static final int DISCS_FOR WIN = 4; 
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public void putDisc(int column) { 


if (numOfDiscs < ROWS) { 
board[column - 1] [numOfDiscs] = 
currentpPplayer; 
printBoard(); 
checkWinCondition(column - 1, 
numOfDiscs); 
switchPlayer (); 


private void checkWinCondition(int col, int row) { 
Pattern winPattern = 
Pattern.compile(".*" + CurrentPlayer + 
"{" + DISCS_FOR_WIN + "}.*"); 


// 检查 垂直 方向 

StringJoiner stringJoiner = 
new StringJoiner(""); 

for (int auxRow = 0; auxRow < ROWS; ++auxRow) { 
stringJoiner 
.add (board[col] [auxRow] .toString()); 


if (winPpattern.matcher (stringJoiner.toString()) 
.matches()) { 
winner = currentPlayer; 
System.out .println(currentPlayer + 
" wins"); 


public boolean isFinished() { 
if (winner != null) return true; 


5.3.7 需求 7 
获胜 条 件 与 前 面相 同 ， 但 方向 不 同 。 


玩家 放 入 碟 片 后 ， 如 果 将 其 3 个 以 上 碟 片 连 成 水 平 线 ， 该 玩家 


实现 这 条 规则 只 需 几 行 代码 ， 如 下 所 示 : 


private voidq checkWinCondition(int col, int row) { 


// 检查 水 平方 向 
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5.3.8 


stringJoiner = new StringJoiner(""); 
for (int column = 0; column < COLUMNS; 
++Column) { 
stringJoiner 
.add (board[column] [row] .tostring()); 


if (winPpattern.matcher (stringJoiner.toString()) 
.matches()) { 
winner = currentPlayer; 
System.out .println(currentPlayer + 
" wins"); 
return; 


需求 8 


这 是 最 后 一 个 获胜 条 件 ， 它 与 前 两 个 获胜 条 件 很 像 ， 但 为 对 角 线 方向 。 





| 县 玩家 放 入 碟 片 后 ， 如 果 将 其 3 个 以 上 碟 片 连 成 对 角 线 ， 该 玩家 将 获胜 。 


下 面 是 这 


类 似 : 


private void checkWinCondition(int col, int row) { 


// 检查 对 角 线 方向 
int startOffset = Math.min(col, row); 
int column = col - startOoffset, 

auxRow = row - startOffset; 
stringJoiner = new StringJoiner(""); 
do { 

stringJoiner 

.add (board[column++] [auxRow++] .toString()); 

} while (column < COLUMNS && auxRow < ROWS ) ; 


if (winPpattern.matcher (stringJoiner.toString()) 
.matches()) { 
winner = currentPlayer; 
System.out .println(currentPlayer + 
" wins")’; 
return; 


startOoffset = Math.min(col, ROWS - 1 - row); 
column = col - startOffset; 
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auxRow = row + startOffset; 
stringJoiner = new StringJoiner(""); 
do { 

stringJoiner 


.add (board[column++] [auxRow--] .toString()); 
} while (column < COLUMNS && auxRow >= 0); 


if (winPattern.matcher (stringJoiner.toString()) 


.matches()) { 
winner = currentPlayer; 


System.out .println(currentPlayer + 


" wins"); 
} 
} 


至 此 ,我 们 创建 了 一 个 类 ， 它 包含 一 个 构造 函数 、3 个 公有 方法 和 3 个 私有 方法 ,应 用 程序 的 
逻辑 分 散在 这 些 方法 中 。 该 实现 最 大 的 缺陷 在 于 ， 这 个 类 很 难 维护 ， 因 为 诸如 checkwin 
Condition 等 重要 方法 都 不 简单 ， 以 后 修改 它们 时 很 容易 引入 bug。 


如 果 要 查看 完整 的 源 代码 ， 可 在 仓库 https://bitbucket.org/vfarcic/tdd-java-ch05-design.git 中 











找到 。 


这 个 小 型 示例 则 在 演示 传统 开发 方法 存在 的 常 
更 大 的 项 目 。 





见 问题 , 要 演示 SOLID 原 则 等 主题 , 需要 使 用 





包含 数 百 个 类 的 大 型 项 目 中 ,如 果 出 现 问 题 , 开发 人 员 需 要 花 很 多 时 间 ， 以 类 似 于 外 科 手 术 
的 方式 解决 。 开发 人 员 的 很 大 一 部 分 时 间 都 花 在 研究 复杂 代码 及 其 工作 原理 上 , 而 无 法 将 这 些 时 


间 用 于 开发 新 功能 。 





5.4 ”使 用 TDD 实现 Connect4 




















至 此 , 我们 知道 了 TDD 的 工作 原理 : 先 编写 测试 ,再 编写 实现 , 然后 进行 重 构 。 我 们 将 使 用 

















这 个 过 程 处 理 每 个 需求 ， 但 只 列 出 最 终结 果 ， 至 于 
为 让 事情 变 得 更 有 趣 ， 我 们 将 尽 可 能 在 测试 中 使 用 








5.4.1 Hamcrest 









































具体 的 “ 红 灯 - 绿 灯 - 重 构 ” 过 程 请 自行 思考 。 


Hamcrest 框 架 。 








第 2 章 说 过 ，Hamcrest 可 提高 测试 的 可 读 性 。 它 使 用 匹配 器 降低 复杂 度 ， 让 断言 的 语义 更 明 
确 、 更 容易 理解 。 测 试 失 败 时 ， 通 过 解读 断言 中 使 用 的 匹配 器 ， 更 容易 理解 显示 的 错误 。 另 外 ， 











开发 人 员 还 可 添加 测试 失败 时 显示 的 消息 。 
Hamcrest 库 充斥 着 各 种 用 于 不 同 对 象 类 型 和 














商 




















合 的 匹配 器 。 下 面 编写 代码 并 体会 Hamcrest 吧 。 
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5.4.2 需求 1 
首先 从 第 一 个 需求 着 手 。 


| 棋盘 为 7 列 6 行 ， 所 有 格子 都 是 空 的 。 


这 个 需求 一 点 都 不 难 。 它 指定 了 棋盘 边界 , 但 没有 描述 任何 行为 ,因此 只 需 确保 游戏 开始 时 
棋盘 为 空 即 可 。 这 意味 着 游戏 开始 时 矶 片 数 为 零 。 然 而 ， 后 面 必须 考虑 这 个 需求 。 


1. 测试 


下 面 是 这 个 需求 的 测试 类 。 其 中 有 一 个 实例 化 受 测 类 的 方法 , 这 个 方法 使 得 每 个 测试 都 将 使 
用 全 新 的 受 测 对 象 ;， 还 有 一 个 测试 ， 它 验证 游戏 开始 时 没有 任何 碟 片 ， 即 整个 棋盘 空空 如 也 : 


public class Connect4TDDSpec { 
































private Connect4TDD tested; 


@Before 
public void peforeEachTest () { 
tested = new Connect4TDD(); 





} 




















@Test 
public void whenTheGameIsStartedTheBoardIsEmpty() { 
assertThat (tested.getNumberOfDiscs(), is(0)); 
} 
} 
2. 代码 
下 面 是 前 一 个 规范 的 TDD 实 现 。 看 看 这 个 针对 第 一 项 需求 的 解决 方案 有 多 简洁 一 一 一 个 通过 


单行 代码 返回 结果 的 简单 方法 : 
public class Connect4TDD { 


public int getNumberOfDiscs() { 
return 0; 


5.4.3 ”需求 2 


下 面 实现 第 二 个 需求 。 
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玩家 从 列 顶 放 入 碟 片 。 如 果 整 列 都 是 空 的 , 放 入 的 碟 片 将 落 到 底部 。 在 特定 
> 列 中 ， 后 放 入 的 碟 片 将 县 在 前 面 放 入 的 碟 片 之 上 。 


可 将 这 个 需求 分 解 为 如 下 测试 : 


口 碟 片 被 加 入 空 列 时 ， 其 位 置 为 0; 
口 碟 片 被 加 入 已 经 有 一 个 碟 片 的 列 时 ， 其 位 置 为 1; 
口 每 加 入 一 个 碟 片 ， 总 碟 片 数 都 加 1; 

口 如 果 碟 片 位 于 棋盘 边界 外 ， 将 引发 运行 阶段 异常 ; 
口 向 已 满 的 列 中 加 入 碟 片 时 ， 将 引发 运行 阶段 异常 。 


其 中 ， 最 后 两 个 测试 是 从 第 一 项 需求 衍生 而 来 的 ， 它 们 与 棋 
1. 测试 
前 述 测试 的 Java 实 现 如 下 : 





























盘 边 界 或 棋盘 行为 相关 。 








@Test 

public void 

whenDiscOutsideBoardThenRuntimeException() { 
int column = -1; 


exception.expect (RuntimeException.class); 

exception.expectMessage ("Invalid column " + 
COLUnin).y 

tested.putDiscInColumn (column); 


} 


@Test 
public void 
whenFirstDiscInsertedInColumnThenPositionIsZero() { 
int column = 1; 
assertThat (tested.putDiscInColumn (column), 
is(0)); 
} 


@Test 
public void 
whenSecondDiscInsertedInColumnThenpPositionIsOne() { 
Tt GOL Es 
tested.putDiscInColumn (column); 
assertThat (tested.putDiscInColumn (column), 
Ey 
3 


@Test 

public void 

whenDiscInsertedThenNumberOfDiscsIncreases() { 
int Column = 13 
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tested.putDiscInColumn (column); 
assertThat (tested.getNumberOfDiscs(), is(1)); 


@Test 
public void 
whenNoMoreRoomInColumnThenRuntimeException() { 
int column = 1; 
int maxDiscsInColumn = 6; // the number of rows 
for (in tmes. ss:.03 
times < maxDiscsInColumn; 
++times) { 
tested.putDiscInColumn (column); 


} 
exception.expect (RuntimeException.class); 
exception 
.expectMessage ("No more room in column " + 
column);} 


tested.putDiscInColumn (column); 


} 
2. 代码 
下 面 是 让 这 些 测试 得 以 通过 的 代码 : 

















private static final int ROWS = 6; 
private static final int COLUMNS = 7; 


private static final String EMPTY = " "; 





[ep 


tring[][] board = 
tring[ROWS] [COLUMNS]; 


private 
new 





[ep 








public Connect4TDD() { 
for (String[] row : board) 
Arrays.fill (row, EMPTY); 


public int getNumberOfDiscs() { 
return IntStream.range(0, COLUMNS) 
.map (this::getNumberOfDiscsInColumn) .sum(); 


private int getNumberOfDiscsInColumn(int column) { 
return (int) IntStream.range (0, ROWS) 
.filter(row -> !EMPTY 
.equals (board[row] [column])) 
OU (0) 


public int putDiscInColumn (int column) { 
checkColumn (column); 
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int row = getNumberOfDiscsInColumn (column); 
checkPositionToInsert (row, column); 
board[row] [column] = "X" 

return row; 


private void checkColumn (int column) { 
if (column < 0 || column >= COLUMNS) 
throw new RuntimeException( 
"Invalid column " + column); 


private void 
checkPositionToInsert (int row, int column) { 
if (row == ROWS) 
throw new RuntimeException( 
"No more room in column " + column); 


5.4.4 需求 3 
第 三 个 需求 规范 了 游戏 逻辑 。 


这 是 一 款 两 人 玩 的 游戏 , 每 位 玩家 的 碟 片 用 一 种 颜色 表示 : 一 位 玩家 为 红色 
> ('R' )， 另 一 位 玩家 为 绿色 ('G' )。 玩 家 轮流 放 入 碟 片 ， 每 次 放 入 一 个 。 


1. 测试 
下 面 的 测试 验证 新 增 的 功能 。 为 简洁 起 见 ， 假 定 总 是 红 方 先 来 : 


@Test 

public void 

whenFirstPlayerPlaysThenDiscColorIisRed() { 
assertThat (tested.getCurrentPlayer(), is("R")); 





@Test 
public void 
whenSecondPlayerPlaysThenDiscColorIsRed() { 

int column = 1; 

tested.putDiscInColumn (column); 

assertThat (tested.getCurrentPlayer(), is("G")); 
} 


2. 代码 


为 实现 这 项 功能 ， 需 要 创建 两 个 方法 。 方 法 putDiscInColumn 中 ， 返回 碟 片 所 在 行 前 调用 
方法 switchPlayer: 


private static final String RED = "R"; 
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private static final String GREEN = "G"; 


private String currentPlayer = RED; 


public Connect4TDD() { 
for (String[] row : board) 
Arrays.fill (row, EMPTY); 
} 


public String getCurrentPlayer() { 
return currentpPlayer; 


} 


private void SwitchPlayer() { 
if (RED.equals (currentPlayer)) 

currentPlayer = GREEN; 

else currentPlayer = RED; 





} 
public int putDiscInColumn (int column) { 


switchpPlayer(); 
return row; 





5.4.5 需求 4 
接 下 来 ， 需 要 让 玩家 知道 游戏 的 当前 状态 。 


我 们 要 在 玩家 放 入 碟 片 或 发 生 错误 时 提供 反馈 : 每 当 玩家 放 入 碟 片 后 , 都 使 
一 ”用 输出 指出 棋盘 的 状态 。 


1. 测试 


发 生 错误 时 应 引发 异常 ， 但 前 面 的 测试 已 覆盖 这 一 点 ， 因 此 这 里 只 需 编 写 两 个 测试 。 另 外 ， 
为 提高 可 测试 性 , 我 们 需要 在 构造 函数 中 新 增 一 个 参数 ,通过 引入 这 个 参数 , 输出 测试 将 更 容易 : 














private OutputStream output; 


@Before 
public void peforeEachTest () { 
output = new ByteArrayOutputStream();} 
tested = new Connect4TDD ( 
new PrintStream(output)); 


} 


@Test 
public void 
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whenAskedForCurrentPlayerTheOutputNotice() { 
tested.getCurrentPlayer(); 
assertThat (output .toString()， 
containsString("Player R turn")); 


@Test 
DuBlic -void 
whenADiscIsIntroducedTheBoardIsPrinted() { 
int column = 1; 
tested.putDiscInColumn (column); 
assertThat (output .toString()， 
containsstring("| IRI | | | | 1")); 


} 
2. 代码 


下 面 是 让 前 述 测 试 通过 的 一 种 可 能 实现 。Connect4TDD 类 的 构造 函数 现在 有 一 个 参数 ， 多 个 
方法 中 都 使 用 了 这 个 参数 以 输出 有 关 事 件 或 操作 的 描述 : 


private static final String DELIMITER = "|"; 




















public Connect4TDD (PrintStream out) { 
outputChannel = out; 
for (String[] row : board) 
Arrays.fill (row, EMPTY); 


public String getCurrentPlayer() { 
outputChannel .printf ("Player %s turngsn", 
currentPlayer);} 
return currentPplayer; 


private void printBoard() { 
for (int row = ROWS - 1; row >= 0; row--) { 
StringJoiner stringJoiner = 
new StringJoiner (DELIMITER, 
DELIMITER, 
DELIMITER); 
Stream.of (board[row]) 
.forEachOrdered (stringJoiner::add); 
outputChannel 
.println(stringJoiner.toString()); 


public int putDiscInColumn (int column) { 


printBoard(); 
switchPplayer(); 
return row; 
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5.4.6 需求 5 


这 个 需求 告诉 系统 游戏 是 否 结 
| 无 法 再 放 入 碟 片 时 游戏 结 来， 结果 为 平局 。 


1. 测试 
需要 测试 的 条 件 有 两 个 ， 一 是 游戏 刚 开 始 时 肯定 未 结束 ， 二 是 棋盘 已 满 时 必须 结束 : 


@Test 
public void whenTheGameStartsItIsNotFinished() { 
assertFalse("The game must not be finished", 
tested.isFinished()); 























} 


@Test 
public void 
whenNoDiscCanBeIntroducedTheGamesIsFinished() { 
for (int row = 0; row < 6; row++) 
for (int column = 0; column < 7; column++) 
tested.putDiscInColumn (column); 
assertTrue ("The game must be finished", 
tested.isFinished()); 





} 
2. 代码 
下 面 是 这 两 个 测试 的 简单 解决 方案 : 


public boolean isFinished() { 
return getNumberOfDiscs() == ROWS * COLUMNS; 

















} 


5.4.7 需求 6 
这 是 第 一 个 获胜 条 件 。 


| 县 玩家 放 入 碟 片 后 ， 如 果 将 其 3 个 以 上 碟 片 连 成 重 直线 ， 该 玩家 将 获胜 。 


1. 测试 
事实 上 ， 只 需 做 一 项 检查 一 一 如 果 当 前 加 入 的 碟 片 与 其 他 3 个 碟 片 连 成 一 条 水 平 线 ， 则 当前 
玩家 将 获胜 : 


@Test 
public void 
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when4VerticalDiscsAreConnectedThenpPlayerWins() { 

for (int row = 0; row < 3; row++) { 
tested.putDiscInColumn(1); // R 
tested.putDiscInColumn(2); // G 

} 

assertThat (tested.getWinner(), 
isEmptyString()); 

tested.putDiscInColumn(1); // R 

assertThat (tested.getWinner(), is("R")); 





} 
2. 代码 




















对 方法 putDiscIncolumn 做 了 两 个 修改 。 还 创建 了 一 个 新 方法 checkWinner: 
private static final int DISCS_TO_WIN = 4; 
private String winner = ""; 
private void checkWinner (int row, int column) { 
if (winner.isEmpty()) { 

String colour = board[row] [column]; 

Pattern winPattern = 

Pattern.compile(".*" + Colour + "{" + 

DISCS_TO_WIN + "}.*"); 
String vertical = IntStream.range(0, ROWS) 
.mapToObj (r -> board[r] [column]) 
.reduce (String::concat) .get (); 
if (winPattern.matcher(vertical) .matches()) 
winner = colour; 
} 
} 
5.4.8 需求 7 

AS A | SS 
这 是 第 二 个 获胜 条 件 ， 与 前 一 个 获胜 条 件 很 像 。 
全、 玩家 放 入 矶 片 后 ， 如 果 将 其 3 个 以 上 碟 片 连 成 水 平 线 ， 该 玩家 将 获胜 。 


1. 测试 
这 次 我 们 尝试 在 相 邻 的 列 中 插入 碟 片 以 获胜 : 





@Test 
public void 
when4HorizontalDiscsAreConnectedThenpPplayerWins() { 
int column; 
for (column = 0; column < 3; column++) { 
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tested.putDiscInColumn (column); // R 
tested.putDiscInColumn (column); // G 
assertThat (tested.getWinner(), 


isEmptyString()); 
tested.putDiscInColumn (column); // R 
assertThat (tested.getWinner(), is("R")); 


} 
2. 代码 
使 这 个 测试 通过 的 代码 被 加 入 方法 cneckwinners 中 : 





if (winner.isEmpty()) 
String horizontal 
Stream 
of (board [row]) 
.reduce (String::concat) .get (); 
if (winPpattern.matcher (horizontal) 
.matches ()) 
winner = colour; 


{ 


—_- 





5.4.9 需求 8 
这 是 最 后 一 个 获胜 条 件 。 


| 全 玩家 放 入 碟 片 后 ， 如 果 将 其 3 个 以 上 碟 片 连 成 对 角 线 ， 该 玩家 将 获胜 。 


1. 测试 


我 们 需要 执行 有 效 的 走 法 以 满足 这 个 条 件 。 在 这 里 ， 需 要 检查 棋盘 的 两 条 对 角 线 : 从 右上 
角 到 左下 角 的 对 角 线 以 及 从 右 下 角 到 左上 角 的 对 角 线 。 下 面 的 测试 使 用 了 一 个 列 号 列表 重 现 受 
测 场 景 : 

@Test 

public void 


when4DiagonallDiscsAreConnectedThenThatPlayerWins () 


{ 




















int[] gameplay = 
niew Tnt ll {tl 2 DS 3 0 
for (int column : gameplay) { 
tested.putDiscInColumn (column); 


} 
assertThat (tested.getWinner(), is("R")); 


@Test 
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public void 
when4Diagonal2DiscsAreConnectedThenThatPlayerWins () 
{ 

int[] gameplay = 

new "inmtl] :tS My 2 Bs Dn 2 To dr 
for (int column : gameplay) { 
tested.putDiscInColumn (column); 

3 

assertThat (tested.getWinner(), is("G")); 
} 


2. 代码 
同样 ， 需 要 修改 方法 checkwinner， 以 添加 新 的 棋盘 检查 : 


if (winner.isEmpty()) { 
int startOffset = Math.min(column, row); 
int myColumn = column - startoffset, 
myRow = row - startOffset; 
StringJoiner stringJoiner = 
new StringJoiner(""); 
do { 
stringJoiner 
.add (board[myRow++] [myColumn++] ); 
} while (myColumn < COLUMNS &é& 
myRow < ROWS); 
if (winpattern 
.matcher (StringJoiner .toString() ) 
.Imatches () ) 
winner = currentPplayer; 


if (winner.isEmpty()) { 
int startOffset = 
Math.min(column, ROWS - 1 - row); 
int myColumn = column - startoffset, 
myRow = row + startOffset; 
StringJoiner stringJoiner = 
new StringJoiner(""); 
do { 
stringJoiner 
.add (board [myRow--] [myColumn++] ); 
} while (myColumn < COLUMNS &é& 
myRow >= 0); 
if (winPatterDn 
.matcher (stringJoiner.toString()) 
.matches () ) 
winner = currentPlayer; 


} 


我 们 使 用 TDD 创 建 了 一 个 类 , 它 包 含 一 个 构造 函数 、5 个 公有 方法 和 6 个 私有 方法 。 总 体 而 言 ， 
这 些 方法 都 看 起 来 非常 简单 且 易 于 理解 , 但 有 一 个 方法 较 大 一 一 检查 获胜 条 件 的 checkWinner。 
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这 种 方法 的 优点 是 ,提供 了 很 有 帮助 的 测试 ， 可 确保 未 来 修改 方法 时 不 会 改变 其 行为 。 代 码 履 盖 
率 不 是 最 终 目 标 ， 但 我 们 获得 的 代码 覆盖 率 确实 很 高 。 


另外 , 为 方便 测试 , 我 们 重 构 了 connect4TDD 类 的 构造 函数 , 使 其 将 一 个 输出 通道 作为 参数 。 
这 样 , 以 后 需要 修改 游戏 状态 的 输出 方式 时 将 更 容易 一 一 无 需 像 传统 方法 中 那样 蔡 换 所 有 输出 通 
道 。 换 言 之 ， 这 个 实现 的 可 扩展 性 更 强 。 


大 型 项 目 中 ,如 果 发 现 需 要 为 一 个 类 创建 大 量 测试 ,应 按 单一 职责 原则 将 它 分 成 多 个 类 。 鉴 
于 我 们 将 输出 工作 委托 给 一 个 初始 化 期 间 以 参数 方式 传人 的 外 部 类 , 因此 一 种 更 优雅 的 解决 方案 
是 ,创建 一 个 包含 高 级 输出 方法 的 类 ,从 而 将 输出 逻辑 和 游戏 逻辑 分 开 。 前 面 所 说 的 都 是 使 用 TDD 
实现 的 良好 设计 带 来 的 好 人 处 。 









































区 Connect4 > 出 com.packtpublishing.tddiava.ch05connect4 > @ Connect4TDD 


Connect4TDD 


Element Missed Instructionss Cov.$ Missed Branches Cov.s Missed$ Cxty$ Misser 
© checkWinner(int, int Es 100% Es 100% 0 13 
© Connect4TDDI(PrintStream 100% 国 100% 0 
© printBoard() 100% ”加 100% 0 
© putDiscinColumn(int) 100% nla 0 
© checkColumn(int 100% 有 75% 
© checkPositionTolnsertfint int 100% 加 100% 0 
© getCurrentPlayer| 100% nla 0 
0 
0 
0 
0 
0 
1 





Liness Missed*> Methods 
29 





= 
Amoaooaonoomon oo 


© SwitchPlayer 100% 100% 
© getNumberOfDiscsinColumn(int) 日 100% n/a 
© getNumberOfDiscs(} 有 100% nla 
© isFinishedl BE 100% 国 100% 
© getWinner() 100% n/a 


d 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
1 0 
Total 0of 356 100% 1of38 97% 0 


oooooocoooeoeoeooeo 


1 
1 
1 
1 
和 
人 
清 
1 
1 
1 
2 


[ED 


中 


1 

















使 用 这 种 方法 编写 的 代码 可 在 https://bitbucket.org/vfarcic/tdd-java-ch05-design.git 找 到 。 











5.5 小结 

本 章 简要 介绍 了 软件 设计 和 几 个 基本 的 设计 原则 。 我 们 使 用 两 种 方法 实现 了 一 个 功能 齐备 的 
桌面 游戏 Connect4: 传统 方法 和 测试 驱动 开发 方法 。 

我 们 分 析 了 这 两 个 解决 方案 的 优 缺 点 ， 并 使 用 了 Hamcrest 框 架 强 化 测试 。 

最 后 得 出 结论 : 这 两 种 方法 都 能 实现 良好 设计 和 良好 实践 , 但 TDD 可 引导 开发 人 员 走 上 更 正 
确 的 道路 。 

要 更 深入 地 了 解 本 书 介绍 的 主题 ， 强 烈 推 荐 你 阅读 Robert C. Martin 的 两 部 著作 :《 代 码 整洁 
之 道 》 和 《敏捷 软件 开发 : 原则 、 模 式 与 实践 》 
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模拟 一 一 消除 外 部 依赖 








“空谈 没有 意义 ， 上 代码 吧 。” 
一 一 林 纳 斯 . 托 瓦 效 

TDD 旨 在 提高 速度 。 我 们 要 快速 验证 理念 、 概 念 或 实现 是 否 有 效 ， 还 要 快速 运行 所 有 测试 。 
影响 这 种 速度 的 主要 瓶颈 是 外 部 依赖 。 创 建 测试 所 需 的 DB 数据 可 能 需要 很 长 时 间 ; 对 使 用 第 三 
方 API 的 代码 进行 验证 的 测试 执行 起 来 可 能 很 慢 ; 最 重要 的 是 ， 编 写 满足 所 有 外 部 依赖 的 测试 可 
能 很 复杂 ， 复 杂 到 不 值得 编写 。 模 拟 外 部 和 内 部 依赖 可 帮助 我 们 解决 这 些 问 题 。 

本 章 将 以 第 3 章 所 做 的 工作 为 基础 ， 对 “ 井 字 游 戏 ” 进 行 扩展 一 一 使 用 MongoDB 存 储 数 据 。 
但 单元 测试 并 不 会 使 用 MongoDB ， 因 为 所 有 通信 都 是 模拟 的 。 最 后 ， 我 们 将 创建 一 个 集成 测试 ， 
以 验证 代码 和 MongoDB 是 否 很 好 地 集成 在 一 起 。 

































































本 章 涵盖 如 下 主题 : 
口 模拟 ; 
口 Mockito; 





口 “ 井 字 游 戏 ”第 二 版 的 需求 ; 
口 开发 “ 井 字 游戏 ”第 二 版 ; 
口 集成 测试 。 





6.1 模拟 


无 论 什 么 人 ， 只 要 开发 过 比 Hello World 复 杂 的 应 用 程序 ， 就 知道 Java 代 码 充 斥 着 依赖 。 这 些 
依赖 可 能 是 其 他 小 组 成 员 编 写 的 类 和 方法 、 来 自 第 三 方 库 的 类 和 方法 ,或 要 与 之 通信 的 外 部 系统 ; 
即便 是 JDK 中 的 库 ， 也 是 依赖 。 我 们 可 能 有 一 个 业务 层 ， 它 与 数据 访问 层 通 信 ， 而 数据 访问 层 又 
使 用 数据 库 驱 动 程序 获取 数据 。 编 写 单元 测试 时 , 依赖 的 范围 更 广 , 甚至 要 将 所 有 的 公有 和 受 保 
护 的 方法 ( 即便 这 些 方法 位 于 受 测 类 ) 视 为 依赖 ， 进 而 将 其 隔离 。 
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在 单元 测试 层面 使 用 TDD 时 ,如 果 规 范 需要 考虑 所 有 这 些 依 赖 , 创建 将 过 于 复杂 ， 导 致 测试 
本 身 成 为 瓶 贷 。 开 发 测试 的 时 间 可 能 急 增 , 导致 TDD 带 来 的 好 处 很 快 被 不 断 增 加 的 成 本 抵消 。 更 
重要 的 是 ， 这 些 依赖 常常 导致 测试 非常 复杂 ， 以 至 于 它们 包含 的 bug 比 实现 本 身 还 多 。 


单元 测试 旨 在 验证 单个 单元 是 否 正常 ， 而 不 考虑 依赖 , TDD 中 的 单元 测试 尤其 如 此 。 对 于 内 
部 依赖 ,我 们 已 对 其 进行 过 测试 ， 知 道 它们 的 行为 符合 预期 ; 但 对 于 外 部 依赖 ， 你 也 必须 信任 它 
们 一 一 相信 它们 能 够 正常 工作 。 就 算 你 不 信任 ， 要 对 其 (如 JDK 包 java.nio 中 的 类 ) 进行 深入 
测试 ， 工 作 量 也 太 大 。 田 外， 运行 功能 测试 和 集成 测试 时 ， 这 些 潜在 的 问题 将 浮 出 水 面 。 


为 专注 于 单元 , 我 们 必须 竭力 消除 它 可 能 使 用 的 所 有 依赖 , 这 是 通过 结合 利用 设计 和 模拟 实 
现 的 。 








使 用 模拟 对 象 
其 优点 包括 ， 代 码 依赖 更 少 ; 测试 执行 速度 更 快 。 
a 要 快速 执行 测试 并 专注 于 单个 功能 单元 ,必须 使 用 模拟 对 象 。 通过 模拟 受 测 
电 方法 的 外 部 依赖 ,开发 人 员 能 够 专注 于 手头 的 任务 ,而 无 需 花 时 间 建 立 这 些 依赖 。 
在 小 组 较 大 或 多 个 小 组 协同 工作 的 情况 下 ， 这 些 依赖 其 至 可 能 还 没有 开发 出 来 。 
另外 , 不 使 用 模拟 对 象 的 情况 下 , 测试 的 执行 速度 通常 很 慢 。 模拟 对 象 非常 适合 
用 于 代替 数据 库 、 其 他 产品 、 服 务 等 。 





深入 介绍 模拟 对 象 前 ， 先 讲解 使 用 原因 。 


6.1.1 为 何 使 用 模拟 对 象 
下 面 列 出 了 一 些 使 用 模拟 对 象 的 原因 。 


口 对 象 的 结果 不 确定 。 例 如 ， 每 次 实例 化 java.util.Date 时 ， 得 到 的 结果 都 不 同 ， 我 们 
无 法 检查 其 结果 是 否 符合 预期 : 








java.util.Date date = new java.util.Date(); 
date.getTime();// 这 个 方法 返回 的 结果 是 什么 呢 ? 


口 对 象 不 存在 。 例 如 ， 我 们 可 能 创建 一 个 接口 并 对 其 进行 测试 ， 但 测试 使 用 这 个 接口 的 代 

码 时 ， 实 现 这 个 接口 的 对 象 可 能 还 没有 编写 好 。 

口 对 象 速度 缓慢 ， 需 要 时 间 处 理 。 最 常见 的 例子 是 数据 库 。 我 们 可 能 编写 了 获取 所 有 记录 

并 生成 报告 的 代码 ， 这 种 操作 可 能 需要 几 分 钟 、 几 小 时 乃至 几 天 。 

上 述 使 用 模拟 对 象 的 原因 适用 于 所 有 类 型 的 测试 , 然而 , 对 于 单元 测试 ( 尤其 是 TDD 中 的 单 

元 测试 ) 来 说 , 还 有 一 个 原因 ， 可 能 比 其 他 原因 都 重要 : 通过 模拟 可 隔离 当前 方法 使 用 的 所 有 依 
赖 ， 这 让 我 们 能 够 专注 于 单个 单元 ， 忽 略 其 调用 的 代码 内 部 工作 原理 。 
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6.1.2 术语 

术语 可 能 有 点 令 人 迷惑 ， 尤 其 不 同 的 人 会 对 同样 的 事物 使 用 不 同名 称 。 雪上 加 霜 的 是 , 模拟 
框架 给 方法 命名 时 也 不 统一 。 

继续 介绍 前 ， 先 简单 学 习 术 语 。 


测试 蔡 身 是 下 面 各 种 替身 的 统称 : 






























































口 哑 元 对 象 (dummy object ) 用 于 替换 真正 的 方法 参数 ; 

口 测试 存根 〈test stub ) 用 于 将 实际 对 象 替换 为 测试 特定 对 象 ， 以 便 向 受 测 系统 提供 所 需 的 
间接 输入 ; 

口 测试 间谍 ( test spy ) 记录 受 测 系统 (SUT ) 向 另 一 个 组 件 发 出 的 间接 输出 调用 ， 让 测试 
随后 能 够 进行 验证 ; 

D 模拟 对 象 (mock object ) 用 于 将 受 测 系统 依 赖 的 对 象 奉 换 为 测试 特定 对 象 ， 以 验证 SUT 
是 否 正确 使 用 ; 

口 伪造 对 象 ( fake object ) 用 于 将 受 测 系统 依赖 的 组 件 蔡 换 为 量 级 更 轻 的 实现 。 








如 果 你 仍 感到 迷惑 ， 没 关系 ,其 实 这 样 的 人 不 止 你 一 个 。 雪 上 加 霜 的 是 , 不同 的 框架 和 作者 
并 未 就 这 些 定义 和 命名 标准 达成 一 致 。 这 导致 术语 混乱 而 不 一 致 ,前 述 术语 的 定义 并 非 被 大 家 普 
饥 接受 。 

出 于 简化 考虑 ， 本 书 将 始终 使 用 Mockito (我 们 使 用 的 框架 ) 采用 的 命名 约定 。 这 样 ， 你 使 
用 的 方法 将 与 后 面 学 到 的 术语 保持 一 致 。 我 们 将 继续 使 用 统称 “模拟 ”, 而 其 他 人 可 能 称 之 为 “ 测 
试 替身 ”。 另 外 ,我 们 将 使 用 模拟 对 象 或 间谍 表示 Mockito 方 法 。 
































6.1.3 ”模拟 对 象 


模拟 对 象 模拟 实际 对 象 (通常 很 复杂 ) 的 行为 ,让 我 们 能 够 创建 对 象 以 替换 实现 代码 中 使 用 
的 实际 对 象 。 模拟 对 象 期 望 使 用 指定 参数 调用 指定 方法 ,以 返回 预期 的 结果 ， 它 预先 知道 应 发 生 
什么 情况 以 及 我 们 期 望 它 做 何 反应 。 

下 面 看 一 个 简单 的 示例 : 


TicTacToeCollection collection = 
mock (TicTacToeCollection.class); 











assertThat (collection.drop()).isFalse(); 
doReturn(true) .when (collection) .drop(); 


assertThat (collection.drop()).isTrue(); 


首先 ， 我 们 将 collection 定 义 为 一 个 可 替换 TicTacToecollection 的 模拟 对 象 。 此 时 这 
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个 模拟 对 象 的 所 有 方法 都 是 伪造 的 ( fake )， 在 Mockito 中 意味 着 返回 默认 值 。 第 二 行 也 确认 了 这 
一 点 ， 它 断言 方法 arop 返 回 false。 接 下 来 ,我 们 指定 模拟 对 象 collection 应 在 其 方法 arop 被 调 
用 时 返回 true。 最 后 ,我 们 断言 方法 drop 返 回 true。 


这 个 示例 中 , 我 们 创建 一 个 返回 默认 值 的 模拟 对 象 , 然后 指定 它 的 一 个 方法 应 返回 的 值 。 自 
始 至 终 都 未 使 用 实际 对 象 。 

本 章 后 面 将 使 用 间谍 ,其 逻辑 与 模拟 对 象 相反 : 除非 另 有 说 明 ， 和 否则 使 用 实际 方法 。 稍 后 开 
始 扩展 “并 字 游 戏 ” 应 用 程序 时 ， 你 将 更 深入 地 了 解 模 拟 。 现 在 先 来 看 看 Java 模 拟 框架 Mockito。 




















6.2 Mockito 


Mockito 是 一 个 模拟 框架 ， 其 API 简 单 而 整洁 。 使 用 Mockito 生 成 的 测试 直观 而 易于 理解 ， 它 
提供 了 三 个 主要 的 静态 方法 : 


口 mock () : 用 于 创建 模拟 对 象 ， 还 可 使 用 when () 和 given () 指定 这 些 模拟 对 象 的 行为 。 

口 spy () : 可 用 于 实现 部 分 模拟 。 除 非 男 有 说 明 ， 否则 间谍 对 象 调用 实际 方法 。 与 模拟 对 象 
一 样 ， 对 于 间谍 对 象 的 每 个 公有 或 受 保护 的 方法 〈 静态 方法 除外 )， 都 可 设置 其 行为 。 主 
要 差别 在 于 ，mock () 创建 一 个 完全 伪造 的 对 象 ， 而 spy () 使 用 实际 对 象 。 

口 verify() : 用 于 检查 调用 方法 时 提供 的 是 否 是 指定 参数 ， 这 是 一 种 断言 。 


后 面 编写 “并 字 游 戏 ” 第 二 版 时 ， 将 更 深入 地 介绍 Mockito， 但 在 此 之 前 ， 先 简单 介绍 这 个 
游戏 新 增 的 需求 。 















































6.3 “ 井 字 游戏 ”第 二 版 的 需求 


“ 井 字 游戏 ”第 二 版 的 需求 很 简单 :添加 永久 性 存储 ， 让 玩家 能 够 保存 游戏 的 当前 状态 ， 以 
便 以 后 接着 玩 。 我 们 将 使 用 MongoDB 实 现 这 个 目标 。 


| 在 “ 井 字 游 戏 ” 中 添加 MongoDB 永 久 性 存储 。 ] 


6.4 开发 “ 井 字 游 戏 ”第 二 版 


我 们 将 在 第 3 章 开 发 的 “ 井 字 游戏 ”基础 上 继续 ， 这 个 游戏 当前 的 完整 源 代码 可 在 
https://bitbucket.org/vfarcic/tdd-java-ch06-tic-tac-toe-mongo.git 找 到 。 请 在 Intellij IDEA 中 使 用 
VCS > Checkout from Version Control > Git 复 制 这 些 代码 。 与 其 他 项 目 一 样 ， 我 们 首先 要 在 
build.gradle 中 添加 依赖: 
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dependencies { 
compile 'org.jongo:jongo:1.1' 
compile 'org.mongodb:mongo-java-driver:2.+' 
testCompile 'junit:junit:4.11' 
testCompile 'org.mockito:mockito-all:1.+' 


} 

导入 MongoDB 驱 动 程序 的 代码 应 该 是 不 言 自明 的 。Jongo 是 一 个 很 有 用 的 实用 方法 集 ， 让 你 
能 够 像 使 用 Mongo 查 询 语言 一 样 使 用 Java 代 码 访问 MongoDB 数 据 库 。 对 于 测试 , 我 们 将 继续 使 用 
JUnit， 同 时 使 用 Mockito 模 拟 对象 、 间 诬 和 验证 。 

你 将 发 现 ， 我 们 要 等 到 开发 接近 尾声 才 安 装 MongoDB。 有 了 Mockito ， 我 们 不 再 需要 
MongoDB ， 因 为 我 们 将 模拟 所 有 Mongo 依 赖 。 


指定 依赖 后 ， 别 忘 了 在 IDEA Gradle projects 对 话 框 中 刷新 。 
































源 代 码 可 在 Git 仓 库 tdd-java-ch06-tic-tac-toe-mongo 的 分 支 00-prerequisites 
( https://bitbucket.zorg/vfarcic/tdd-java-ch06-tic-tac-toe-mongo/branch/00-prerequisites ) 中 找到 。 


做 好 准备 工作 后 ， 下 面 着 手 处 理 第 一 个 需求 。 








6.4.1 需求 1 


我 们 需要 将 每 步 棋 都 存储 到 数据 库 。 鉴 于 所 有 游戏 逻辑 都 已 实现 ,这 项 工作 应 该 很 简单 。 尽 
管 如 此 ， 这 个 示例 将 淋漓 尽 致 地 展示 模拟 对 象 的 用 法 。 























| 实现 一 个 保存 单 步 棋 一 一 包含 轮 次 、X 和 YY 坐标 以 及 玩家 (X 或 0 ) 一 一 的 
> 选项 。 


1. 规范 和 实现 


我 们 应 首先 定义 用 于 表示 数据 存储 模式 (schema ) 的 Javabean。 这 没什么 特殊 的 ， 故 省 略 该 
部 分 ， 只 对 此 稍 加 说 明 。 


不 要 花 太 多 时 间 定 义 针对 Java 样 板式 代码 的 规范 。 我 们 的 bean 实 现 包 含 重 写 的 ecuals 和 
hashcode， 它 们 都 是 IDEA 自动 生成 的 。 除 了 满足 对 两 个 相同 类 型 的 对 象 进行 比较 的 需求 外 ， 
没有 其 他 实际 价值 (后 面 的 规范 中 将 使 用 这 种 比较 )。TDD 可 帮助 我 们 改善 设计 质量 、 编 写 更 好 
的 代码 ,但 编写 15~20 个 规范 以 定义 原本 可 由 IDE 生 成 的 样板 式 代码 ( 如 方法 equals )， 并 不 能 帮 
助 我 们 实现 这 样 的 目标 。 要 掌握 TDD ， 不 仅 要 学 会 如 何 编写 规范 ， 还 要 知道 什么 样 的 规范 不 值 
得 编写 。 


话 虽 如 此 ， 要 了 解 完 整 的 bean 规 范 和 实现 ， 请 参阅 源 代 码 。 
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这 些 源 代码 可 在 Git 仓 库 tdd-java-ch06-tic-tac-toe-mongo 的 分 支 01-bean 
( https://bitbucket.org/vfarcic/tdd-java-ch06-tic-tac-toe-mongo/branch/01-bean ) 中 找到 。 包 含 bean 规 
范 和 实现 的 类 分 别 为 TicTacToeBeanSpec 和 TicTacToeBean。 

















下 面 进入 更 有 趣 的 部 分 ， 编 写 将 数据 存储 到 MongoDB 的 相关 规范 ( 这 部 分 也 没有 使 用 模拟 
对 象 、 间 谍 和 验证 )。 








对 于 这 个 需求 ,我 们 将 在 com.packtpublishing.tqddjava.ch03tictactoe.mongo 包 中 
创建 两 个 新 类 : TicTacToeCollectionSpec( 在 src/test/java 中 ) 和 TicTacToeCollection 
(在 src/main/java 中 )。 








2. 规范 
我 们 应 规范 将 使 用 的 数据 库 名 称 : 
@Test 


public void 
whenIinstantiatedThenMongoHasDbNameTicTacToe() { 
TicTacToeCollection collection = 
new TicTacToeCollection(); 
assertEquals!( 
"Ere=tacstoa, 
collection.getMongoCollection() 
.getDBCollection() .getDB() .getName()); 
} 


实例 化 一 个 ricTacToecollection 类 ， 并 验证 数据 库 名 称 是 我 们 期 望 的 。 





3. 实现 
实现 非常 简单 ， 如 下 所 示 : 


private MongoCollection mongoCollection; 
protected MongoCollection getMongoCollection() { 
return mongoCollection; 
} 
public TicTacToeCollection() 
throws UnknownHostException { 
DB db = new MongoClient() .getDB("tic-tac-toe"); 
mongoCollection = 
new Jongo (db) .getCollection ("bla"); 
} 


实例 化 TicTacToeCollection 类 时 , 使 用 指定 数据 库 名 称 (tic-tac-toe ) 创建 一 个 新 的 
Mongocollection 对 象 ， 并 将 其 赋 给 一 个 局 部 变量 。 




















请 耐心 等 待 ， 再 完成 一 个 规范 ， 我 们 就 将 进入 有 趣 的 部 分 ， 届 时 将 使 用 模拟 对 象 和 间 训 


a 





[e) 
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4. 规范 


前 一 个 实现 使 用 了 集合 名 bla， 因 为 Jongo 要 求 我 们 必须 指定 一 个 字符 串 。 下 面 创建 一 个 规 
以 指定 将 使 用 的 Mongo 和 集合 的 名 称 : 


@Test 
public void 
whenInstantiatedThenMongoCollectionHasNameGame() { 
TicTacToeCollection collection = new 
TicTacToeCollection(); 
assertEquals( 
"game", 
collection.getMongoCollection() 
.getName () ) ; 








这 


} 
这 个 规范 与 前 一 个 儿 乎 完全 相同 ， 且 很 可 能 是 不 言 自明 的 。 























5. 实现 
为 实现 这 个 规范 ， 只 需 修改 用 于 设置 集合 名 的 字符 串 : 











public TicTacToeCollection() 
throws UnknownHostException { 
DB db = new MongoClient() .getDB("tic-tac-toe"); 
mongoCollection = 
new Jongo (db) .getCollection("game"); 


} 
6. 重 构 


你 可 能 以 为 重 构 是 专 为 实现 代码 准备 的 , 但 由 其 目标 ( 更易 读 、 更 佳 、 速 度 更 快 的 代码 ) 可 
知 ， 重 构 既 可 用 于 实现 ， 也 可 用 于 规范 。 


前 面 两 个 规范 都 实例 化 了 micTacToecollection 类 , 我 们 可 以 将 这 些 重复 的 代码 移 到 一 个 
用 eBefore 注 解 的 方法 中 。 最 终 的 效果 没 变 〈 运 行 每 个 用 erest 注 解 的 方法 前 ， 都 将 实例 化 
TicTacToecollection 类 )， 但 消除 了 重复 代码 。 由 于 后 面 的 规范 也 需要 这 样 的 实例 化 ， 因 此 
消除 重复 将 在 以 后 带 来 更 多 好 处 。 另 外 ， 我 们 还 需 避 免 反 复 编写 引发 UnknownHostException 
异常 的 代码 : 


TicTacToeCollection collection; 


















































@Before 

public void before() throws UnknownHostException { 
collection = new TicTacToeCollection(); 

} 

@Test 

public void 

whenInstantiatedThenMongoHasDbNameTicTacToe() { 
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// throws UnknownHostException { 
pA TicTacToeCollection collection = new 
// TicTacToeCollection(); 


assertEquals ("tic-tac-toe", 
collection.getMongoCollection() 
.getDBCollection() .getDB() 
.getName ()); 
} 


@Test 
public void whenInstantiatedThenMongoHasNameGame () 


{ 


// throws UnknownHostException { 
Wy TicTacToeCollection collection = new 
// TicTacToeCollection(); 


assertEquals ("game", 
collection.getMongoCollection() 
.getName () ); 


使 用 设置 和 拆除 方法 
这 样 做 的 好 处 是 ,这 些 方法 让 我 们 能 够 分 别 在 类 或 各 测试 方法 之 前 和 之 后 执 
行 准 备 (设置 ) 和 销毁 (拆除 ) 代码 。 
我 们 常常 需要 在 测试 类 或 其 每 个 方法 之 前 执行 一 些 代码 ， 为 此 ，JUnit 提 供 
、 了 注解 @BeforeClass 和 @Before, 其 中 注解 QBeforeClass 在 类 被 加 载 前 (第 
ea 一 个 测试 方法 运行 前 ) 执行 与 它 相 关联 的 方法 , 而 @Before 在 每 个 测试 运行 前 执 
行 与 它 相 关联 的 方法 。 这 两 个 注解 用 于 测试 存在 前 置 条 件 的 情形 , 最 常见 的 例子 
是 在 数据 库 ( 很 可 能 位 于 内 存 ) 中 设置 测试 数据 。 与 这 两 个 注解 对 应 的 是 After 
和 Afterclass， 它 们 的 主要 用 途 是 销毁 设置 阶段 或 其 他 测试 创建 的 数据 或 状 
态 。 每 个 测试 都 应 独立 于 其 他 测试 ， 另 外 ， 任 何 测试 都 不 应 受 其 他 测试 的 影响 。 
拆除 阶段 有 助 于 确保 系统 就 像 未 执行 任何 测试 一 样 。 





下 面 做 一 些 模拟 、 监 视 (spying ) 和 验证 工作 ! 
7. 规范 


我 们 需要 创建 一 个 方法 ， 将 数据 保存 到 MongoDB 。 研 究 Jongo 文 档 可 发 现 ， 方法 
MongoCollection.save 所 做 的 就 是 这 样 的 工作 。 它 将 任何 对 象 作为 参数 ， 并 使 用 Jackson 将 其 
转换 为 MongoDB 使 用 的 JSON。 这 里 的 重点 是 ,经 过 对 Jongo 的 一 番 处 理 , 我 们 决定 使 用 ( 更 重要 
的 是 信任 ) 这 个 库 。 

可 以 通过 两 种 方式 编写 Mongo 规 范 ， 其 中 一 种 较为 传统 ， 适 合 端 到 端 (E2E ) 测试 和 集成 测 
试 : 启动 一 个 MongoDB 实 例 ， 调 用 Jongo 方 法 save， 查 询 数据 库 并 确认 数据 确实 保存 到 数据 库 。 
这 还 没有 完 ， 因 为 每 个 测试 前 都 需要 清理 数据 库 ， 确 保 它 处 于 未 被 之 前 的 测试 污染 的 初始 状态 。 
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最 后 ， 所 有 测试 都 执行 完毕 后 ， 还 可 能 要 停止 MongoDB 实 例 ， 以 释放 服务 器 资源 ， 让 其 他 任务 
可 用 。 


你 可 能 猜 到 了 ， 以 这 种 方式 编写 的 测试 需要 做 很 多 工作 。 不 仅 如 此 , 测试 的 执行 时 间 也 将 激 
增 。 运行 一 个 与 数据 库 通 信 的 测试 不 需要 很 长 时 间 ， 运行 10 个 这 样 的 测试 通常 也 很 快 , 但 运行 数 
百 力 至 数 千 个 这 样 的 测试 将 需要 很 长 时 间 。 如 果 运 行 所 有 单元 测试 需要 很 长 时 间 ， 结 果 将 如 何 
呢 ? 大 家 将 失去 耐心 , 开始 将 它们 分 组 甚至 完全 放弃 TDD。 将 测试 分 组 意味 着 我 们 无 法 确信 没有 
破坏 任何 东西 ， 因 为 始终 只 测试 了 部 分 代码 。 至 于 放弃 TDD， 那 可 不 是 我 们 要 力图 实现 的 目标 。 
然而 , 如 果 运 行 测试 需要 很 长 时 间 , 那 就 完全 有 理由 认为 开发 人 员 不 愿 等 到 它们 运行 完毕 后 才 进 
入 下 一 个 规范 。 而 一 旦 开发 人 员 这 样 做 ， 战 行 的 就 不 再 是 TDD。 单元 测试 的 运行 时 间 多 长 算 合理 
呢 ? 没有 放 之 四 海 皆 准 的 规则 ， 但 一 条 经 验 是 : 如 果 时 间 超 过 10~15 秒 ， 就 应 对 此 感到 担 优 ， 并 
花 时 间 对 测试 进行 优化 。 



























































测试 应 能 快速 运行 
这 样 做 的 好 处 是 ， 测 试 将 被 频繁 运行 。 
如 果 测 试 的 运行 时 间 很 长 , 开发 人 员 将 不 再 运行 它们 , 或 者 只 运行 与 所 做 修 
3 改 相 关 的 很 少 一 部 分 测试 。 除 促使 开发 人 员 使 用 它们 外 , 测试 运行 速度 快 的 另 一 
电 个 好 处 是 可 快速 提供 反馈 6。 问题 发 现 得 越 早 , 修复 就 越 容易 ， 因 为 此 时 对 导致 问 
题 的 代码 还 记忆 犹 新 。 如 果 等 待 测试 执行 完毕 期 间 , 开发 人 员 已 开始 着 手 处 理 下 
一 个 功能 ， 他 可 能 决定 将 修复 问题 的 工作 推迟 到 完成 新 功能 后 去 做 。 另 一 方面 ， 
如 果 他 放下 手头 的 工作 去 修复 问题 ， 将 因 调整 思 路 而 浪费 时 间 。 





既然 使 用 真实 的 数据 库 运 行 单 元 测试 不 是 好 的 选择 ， 那 么 有 什么 替代 办 法 吗 ? 模拟 和 监视 ! 
这 个 示例 中 ,我 们 知道 应 调用 第 三 方 库 的 哪个 方法 ,还 投入 足够 的 时 间 确 认 这 个 库 是 可 信任 的 ( 后 
者 还 将 执行 集成 测试 确认 其 是 可 信任 的 )。 知 道 如 何 使 用 这 个 库 后 ， 就 可 将 工作 范围 限定 为 验证 
是 否 正确 调用 了 这 个 库 。 

下 面 就 来 试 一 试 。 

首先 ， 应 该 修改 既 有 代码 ， 将 Ti cTacToeCollect ion 对 象 替 换 为 间谍 




































































import static org.mockito.Mockito.*,; 
@Before 
public void before() throws UnknownHostException { 


collection = spy (new TicTacToeCollection()); 


} 


对 类 进行 监视 称 为 “部 分 模拟 "。 被 监视 时 ， 类 的 行为 与 正常 实例 化 时 完全 相同 ， 主 要 差别 
在 于 ,可 以 应 用 部 分 模拟 ， 对 一 个 或 多 个 方法 进行 替换 。 大 多 数 情 况 下 ,我 们 都 对 要 测试 的 类 进 
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行 监视 ， 因 为 想 保留 其 所 有 功能 ;同时 提供 这 样 的 选择 ， 即 能 够 在 需要 时 模拟 其 一 部 分 。 
下 面 编 写 规范 本 身 ， 它 可 能 如 下 所 示 : 


@Test 
public void 
whenSaveMoveThenInvokeMongoCollectionSave() { 
TicTacToeBean bean = 
new TicTacToeBean(3, 2, 1, 'Y'); 
MongoCollection mongoCollection = 
mock (MongoCollection.class); 
doReturn (mongoCollection) .when (collection) 
.getMongoCollection(); 
collection.saveMove (bean); 
verify(mongoCollection, times(1)).save(bean); 


} 


mock、 doReturn 和 和 veri fy 等 静态 方法 都 来 自 org .mockito.Mockito 类 。 


首先 ， 创建 一 个 新 的 TicTacToeBean 对 象 ， 这 没有 什么 特别 之 处 。 接 下 来 ,根据 
Mongocollection 创 建 一 个 模拟 对 象 。 鉴 于 我 们 已 经 确定 ， 进 行 单元 测试 时 应 避免 直接 与 数据 
库 通信 ， 而 通过 模拟 这 个 依赖 可 达成 这 个 目标 。 模 拟 将 真实 类 转换 为 模拟 类 ， 在 使 用 
mongoCollection 的 类 看 来 ， 它 就 像 一 个 真实 的 类 。 但 在 幕后 ， 它 的 所 有 方法 都 是 shallow， 即 
什么 都 不 做 : 就 像 重 写 了 这 个 类 ， 将 其 所 有 方法 都 改 为 空 : 


MongoCollection mongoCollection = 
mock (MongoCollection.class); 


接 下 来 指出 , 每 当 调 用 间谍 对 象 collection 的 方法 getMongoCcollection 时 , 都 应 返回 模 
拟 对 象 mongocollection。 换 言 之 , 我 们 让 类 使 用 伪造 的 集合 而 不 是 真实 集合 : 

















doReturn (mongoCollection) .when (collection) 
.getMongoCollection(); 


接 下 来 ， 调 用 要 测试 的 方法 : 
collection.saveMove (bean); 


最 后 ， 需 要 验证 是 否 正确 调用 了 Jongo 库 ， 且 只 调用 了 1 次 : 























verify(mongoCollection, times(1)).save(bean); 
下 面 尝 试 实现 这 个 规范 。 
8. 实现 


为 更 好 地 理解 刚才 编写 的 规范 ， 只 提供 部 分 实现 一 一 创建 空 方法 saveMove。 在 不 实现 这 个 
规范 的 情况 下 ， 这 能 够 使 代码 通过 编译 : 
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public void saveMove (TicTacToeBean bean) { 


} 
你 运行 所 有 规范 ( 执行 命令 gradle test ) 时 ,结果 如 下 : 





Wanted but not invoked: 
mongoCollection.savel 
TOriis B33 XR: Zr Yr LT PlayerY 
jj 
Mockito 指 出 ， 从 规范 可 知 ， 我 们 期 望 方 法 mongocollection.save 被 调用 ,但 这 个 期 望 未 
得 到 满足 。 由 于 测试 失败 ,我 们 需要 回去 完成 实现 。 使 用 TDD 时 ,最 大 的 罪过 之 一 是 ,在 测试 未 
通过 的 状态 下 就 去 做 其 他 事情 。 






































仅 当 所 有 测试 都 通过 才 编 写 新 测试 
这 样 做 的 好 处 是 : 专注 于 小 型 工作 单元 , 而 实现 代码 几乎 始终 处 于 能 够 运行 
的 状态 。 
有 时 候 开发 人 员 可 能 很 想 编写 多 个 测试 再 实现 ,还 有 些 时 候 开发 人 员 会 忽略 
测试 检测 到 的 问题 ,接着 添加 新 功能 。 这 些 做 法 都 必须 尽 可 能 避免 。 大 多 数 情况 
下 ,违反 这 个 原则 都 将 引入 需要 “ 连 本 带 息 ”一 起 偿还 的 技术 债务 。 确 保 实 现代 
码 几 乎 始终 像 预 期 的 那样 工作 是 TDD 的 目标 之 一 。 为 按期 交付 或 避免 超 预 算 ， 
有 些 项 目 违 背 这 个 原则 , 将 时 间 都 用 于 开发 新 功能 ; 而 对 于 测试 失败 的 代码 ,会 
推迟 其 修复 工作 。 这 些 项 目 最 终 都 难 逃 推迟 交付 的 命运 。 


下 面 修改 前 面 的 实现 ， 如 下 所 示 : 


public void saveMove (TicTacToeBean bean) { 
getMongoCollection().save(null); 


} 
如 有 果 再 次 运行 规范 ， 结 果 将 如 下 所 示 : 


Argument (s) are different! Wanted: 
mongoCollection.savel( 
这 
)3 
这 次 调用 了 期 望 的 方法 ,但 传递 给 它 的 参数 不 符合 预期 。 在 规范 中 , 我 们 将 期 望 设置 为 一 个 
bean (new TicTacToeBean(3，2，1，'Y') ); 而 在 实现 中 ， 我 们 传递 的 是 null。Mockito 验 证 
不 仅 能 够 指出 是 否 调 用 了 正确 的 方法 ， 还 能 指出 传递 给 这 个 方法 的 参数 是 否 正 确 。 


这 个 规范 的 正确 实现 如 下 所 示 : 
































public void saveMove (TicTacToeBean bean) { 
getMongoCollection() .save(bean); 


} 
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这 次 所 有 规范 都 通过 了 ， 可 以 接着 编写 下 一 个 规范 。 
9. 规范 
将 方法 saveMove 的 返回 类 型 改 为 布尔 值 : 


@Test 
public void whenSaveMoveThenReturnTrue() { 
TicTacToeBean bean = 
new TicTacToeBean(3, 2, 1, 'Y'); 
MongoCollection mongoCollection = 
mock (MongoCollection.class); 
doReturn (mongoCollection) .when (collection) 
.getMongoCollection(); 
assertTrue (collection.saveMove (bean)); 


} 


籽 


C 


10. 实现 


这 个 规范 的 实现 非常 简单 ， 只 需 修改 指定 方法 的 返回 类 型 即 可 。 别 忘 了 ,“ 使 用 尽 可 能 简单 
的 解决 方案 ”是 TDD 规 则 之 一 。 最 简单 的 解决 方案 是 返回 true， 如 下 所 示 : 








public boolean saveMove (TicTacToeBean bean) { 
GetMongocollection().save(bean) ; 
return true; 


} 
11. 重 构 


你 可 能 注意 到 ， 前面 两 个 规范 的 开头 两 行 代码 是 重复 的 。 我们 可 以 重 构 这 些 规范 , 将 这 些 相 
ls fore 注 解 的 方法 中 : 
TicTacToeCollection collection; 


TicTacToeBean bean; 
MongoCollection mongoCollection; 





@Before 

public void before() throws UnknownHostException { 
collection = spy (new TicTacToeCollection()); 
bean = new TicTacToeBean(3, 2, 1, 'Y'); 
mongoCollection = mock (MongoCollection.class); 


@Test 
public void 
whenSaveMoveThenInvokeMongoCollectionSave() { 


区区 TicTacToeBean bean = 

4 new TicTacToeBean(3, 2, 1, 'Y'); 
Ww MongoCollection mongoCollection = 
Ld mock (MongoCollection.class); 


doReturn (mongoCollection) .when (collection) 
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.getMongoCollection(); 
collection.saveMove (bean); 
verify (mongoCollection, times(1)).save (bean); 


@Test 

public void whenSaveMoveThenReturnTrue() { 

VA TicTacToeBean bean = 

// new TicTacToeBean(3, 2, 1, 'Y'); 

0 MongoCollection mongoCollection = 

Va mock (MongoCollection.class); 
doReturn (mongoCollection) .when (collection) 


.getMongoCollection(); 
assertTrue (collection.saveMove (bean)); 


} 


12. 规范 
现在 处 理 使 用 MongoDB 时 可 能 出 错 的 问题 ,例如 ,出 现 异常 时 ,我 们 可 能 要 从 方法 saveMove 


返回 false: 
@Test 
public void 
givenExceptionWhenSaveMoveThenReturnFalse() { 


把 癌 


这 里 引入 男 一 个 Mockito 方 法 





目 
候 
党 


常 ， 这 让 我 们 能 够 断言 方法 saveMove 在 出 现 异 常 时 返回 false。 


doThrow (new MongoException("Bla")) 
.when (mongoCollection) 
.Save (any (TicTacToeBean.class)); 
doReturn (mongoCollection) .when (collection) 
.getMongoCollection(); 
assertFalse(collection.saveMove (bean)); 


} 








“引发 异常 ”。 这 个 规范 在 mongocollection 类 的 方法 save 被 调用 时 引发 Mongol 


13. 实现 
实现 很 简单 ， 只 需 添加 一 个 try/catch 块 即 可 : 


public boolean saveMove (TicTacToeBean bean) { 
tky 
getMongoCollection() .save(bean); 
return true; 
} catch (Exception e) { 
return false; 
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doThrow， 它 类 似 于 doReturn， 但 在 when 设 置 的 条 件 满 


Exception 
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14. 规范 


这 个 应 用 程序 非常 简单 , 只 能 保存 一 盘 棋 一 一 至 少 目 前 是 这 样 的 。 因此 , 每 次 创建 新 实例 时 ， 
都 需 重新 开始 ， 将 数据 库 中 存储 的 所 有 数据 都 删除 。 为 此 ， 最 简单 的 方式 是 删除 整个 MongoDB 
集合 。Jongo 提 供 的 方法 Mongocollection.dqrop () 可 用 于 完成 这 种 任务 。 我 们 将 创建 一 个 类 似 
于 saveMove 的 新 方法 


如 果 以 前 没有 使 用 过 Mockito 、MongoDB 和 Jongo,， 则 很 可 能 无 法 自行 完成 本 章 练习 ， 而 只 能 
按 书 中 说 的 做 。 若 果真 如 此 ， 现 在 你 可 能 想 改 避 易 办 ， 尝 试 自己 编写 规范 和 实现 。 





























drop()。 











我 们 需要 验证 在 TicTacToeCollection 类 的 方法 drop() 中 调用 了 Mongocollection . 
drop ()。 请 先 尝试 自己 编写 这 个 规范 ， 再 查看 下 面 的 代码 。 这 个 规范 应 该 与 save 方 法 相关 的 规 
范 几 乎 相同 : 


@Test 
public void 
whenDropThenInvokeMongoCollectionDrop() { 
doReturn (mongoCollection) .when (collection) 
.getMongoCollection(); 
collection.drop(); 
verify(mongoCollection) .drop(); 


} 
15. 实现 


这 是 一 个 包装 需 方 法 ， 因 此 这 个 规范 实现 起 来 应 该 非常 容易 : 





public void drop() { 
getMongoCollection() .drop(); 
} 


16. 规范 
再 实现 两 个 规范 ，TicTacToeCollection 类 就 完成 。 


下 面 确保 我 们 在 正常 情况 下 返回 true: 


@Test 
public void whenDropThenReturnTrue() { 
doReturn (mongoCollection) .when (collection) 
.getMongoCollection(); 
assertTrue (collection.drop()); 





} 
17. 实现 


如 果 说 使 用 TDD 时 ,， 规范 实现 起 来 都 很 简单 , 那 是 因为 我 们 有 意 为 之 。 将 任务 分 成 很 小 的 实 
体 ， 使 得 大 多 数 规范 的 实现 都 是 小 菜 一 碟 。 这 个 规范 的 实现 也 不 例外 : 
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public boolean drop() { 
getMongoCollection() .drop(); 
return true; 


} 
18. 规范 
最 后 ， 确 保 方 法 drop 在 发 生 异常 时 返回 false: 


@Test 
public void 
givenExceptionWhenDropThenReturnFalse() { 
doThrow (new MongoException("Bla")) 
.when (mongoCollection) 
.drop(); 


doReturn (mongoCollection) .when (collection) 


.getMongoCollection(); 
assertFalse(collection.drop()); 


} 
19. 实现 
为 实现 这 个 规范 ， 只 需 添 加 一 个 try/catch 块 : 


public boolean drop() { 
try { 
getMongoCollection() .drop(); 
return true; 
} catch (Exception e) { 
return false; 
} 
} 

















有 了 这 个 实现 后 , ricTacToecollection 类 就 编写 好 了 , 它 是 我 们 的 主 类 和 MongoDB 的 中 











间 层 。 
源 代 码 可 在 Git 仓 库 tgad-java-ch06-tic- 











tac-toe-mongo 的 分 支 02-save-move 


( https://bitbucket.org/vfarcic/tdd-java-ch06-tic-tac-toe-mongo/branch/02-save-move ) 中 找到 。 规 范 和 
实现 类 分 别 为 TicTacToeCollectionSpec 和 TicTacToeCollection。 


6.4.2 需求 2 


下 面 在 主 类 TicTacToe 中 使 用 TicTacToecollection 方 法 。 每 当 玩家 成 功 落 子 后 , 我 们 都 需 
要 将 这 步 棋 保存 到 数据 库 。 另 外 , 每 当 实 例 化 TicTacToe 类 时 ， 都 需 将 集合 删除 ， 以免 旧 数据 影 
响 新 游戏 。 我 们 原本 可 以 做 得 更 精致 些 , 但 本 章 目 的 是 学 习 如 何 使 用 模拟 ， 因 此 这 里 只 考虑 这 些 
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| 将 每 步 棋 都 保存 到 数据 库 ， 并 确保 开始 新 游戏 时 删除 旧 数 据 。 


下 面 先 做 些 准备 工作 。 

1. 规范 

与 MongoDB 通 信 的 方法 都 位 于 TricTacToecollection 类 ,因此 我 们 需要 确保 对 其 进行 了 实 
例 化 。 这 个 规范 可 以 这 样 编写 : 


@Test 
public void whenInstantiatedThenSetCollection() { 
assertNotNull( 
ticTacToe.getTicTacToeCollection()); 


} 


实例 化 TicTacToe 的 工作 已 经 在 用 @Before 注 解 的 方法 中 完成 。 这 个 规范 中 , 我 们 确保 也 实 
例 化 了 TicTacToeCollection。 


2. 实现 


这 个 实现 没什么 特别 之 处 ， 只 需 修 改 默 认 构 造 函 数 ， 将 一 个 新 的 TicTacToeCollection 实 
例 赋 给 变量 ticTacToeCollection。 


首先 ， 添 加 一 个 类 型 为 ricTacToecollection 的 局 部 变量 及 其 获取 函数 : 





private TicTacToeCollection ticTacToeCollection; 


protected TicTacToeCollection 
getTicTacToeCollection() { 
return ticTacToeCollection; 


} 
现在 , 余下 的 全 部 工作 就 是 在 主 类 被 实例 化 时 ， 实 例 化 一 个 新 集合 ， 并 将 其 赋 给 这 个 变量 : 

















public TicTacToe() throws UnknownHostException { 
this (new TicTacToeCollection()); 
protected TicTacToe 
(TicTacToeCollection collection) { 
ticTacToeCollection = collection; 


} 


我 们 还 提供 了 另 一 种 实例 化 这 个 类 的 方式 : 通过 参数 传人 一 个 TicTacToeCollection 对 
象 。 这 将 在 规范 内 部 派 上 用 场 一 一 使 用 它 轻松 传人 模拟 的 集合 。 


现在 回 到 规范 类 ， 在 其 中 使 用 这 个 新 的 构造 函数 。 
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3. 重 构 规 范 
如 下 所 示 使 用 新 的 ricTacToe 构 造 函 数 ， 





private TicTacToeCollection collection; 


@Before 
public final void before() 
throws UnknownHostException { 
collection = mock (TicTacToeCollection.class); 
/4 ticTacToe = new TicTacToe(); 
ticTacToe = new TicTacToe (collection); 


} 


现在 , 所 有 规范 都 将 使 用 TicTacToeCollection 的 模拟 版 还 有 其 他 注入 模拟 依赖 的 方法 ， 
如 使 用 Spring， 但 我 们 认为 简单 的 方式 胜 过 使 用 复杂 的 框架 。 


4. 规范 





每 当 玩家 落 子 后 ， 都 需 将 这 步 棋 保存 到 数据 库 。 可 以 这 样 编写 相应 规范 : 


@Test 
public void whenplayThenSaveMoveIsInvoked() { 
TicTacToeBean move = 
new TicTacToeBean(1, 1, 3, 'X'); 
ticTacToe.play (move.getX(), move.getY()); 
verify(collection) .saveMove (move); 


} 
至 此 ， 你 应 该 熟悉 了 Mockito， 但 下 面 还 是 详细 介绍 一 下 这 些 代 码 ， 以 帮助 你 复习 : 
(1) 首先 ， 实例 化 一 个 TicTacToeBean 对 象 ， 因为 它 包 含 集 合 期 望 的 数据 : 


TicTacToeBean move = new TicTacToeBean(1, 1, 3, 'X'); 


(2) 接 下 来 ， 该 实际 落 子 了 : 





ticTacToe.play (move.getX(), move.getY()); 


(3) 最 后 ， 需 要 验证 确实 调用 了 方法 saveMove: 








Verify(collection，tLimes(1)) .saveMove (move) ; 
与 本 章 一 直 做 的 一 样 ， 我 们 隔离 所 有 外 部 调用 ， 只 专注 于 当前 要 测试 的 单元 (play )。 别 忘 
了 ， 这 种 隔离 仅 限 于 公有 和 受 保 护 的 方法 。 实 际 实现 中 ， 我 们 可 能 在 公有 方法 play 中 调用 
saveMove， 也 可 能 在 前 面 重 构 时 编写 的 一 个 私有 方法 中 调用 它 。 





实现 


5. 
这 个 规范 带 来 两 个 挑战 。 首 先 ， 我 们 该 在 哪里 调用 方法 saveMove 呢 ? 在 私有 方法 setBox 
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中 调用 看 起 来 是 个 不 错 的 选择 。 这 个 方法 中 ,我 们 检查 落 子 位 置 是 否 有 效 ， 如 果 有 效 ， 就 可 调用 
方法 saveMove。 人 然而 , 方法 saveMove 将 一 个 bean 作 为 参数 ， 而 set Box 当 前 接受 的 参数 为 x、y 
和 1astPlayer， 因 此 我 们 需要 修改 方法 setBox 的 签名 。 


方法 setBox 当 前 是 这 样 的 : 





private void setBox(int x, int y, char lastPlayer) 
{ 
if (Board[le = 1] [ly 11 = YO") A 
throw new RuntimeException!( 
"Box is occupied"); 
} else { 
board[x - 1][ly - 1] = lastPlayer; 
} 
} 


我 们 需要 将 其 修改 如 下 : 


private void setBox(TicTacToeBean bean) { 


if (board[bean.getX() - 1] [bean.getY() 1] 
sy NO 
throw new RuntimeException( 
"Box is occupied"); 
} else { 
board[bean.getx() 1] [bean.getYy() 天国- 一 


lastPlayer; 
getTicTacToeCollection() .saveMove (bean); 


} 
修改 setBox 的 签名 后 , 还 有 其 他 几 个 地 方 也 需要 修改 。 由 于 方法 play 调 用 了 setBox, 我 们 
需要 在 其 中 实例 化 bean: 





public String play (int x, int y) { 
checkAxis (x); 
checkAxis (y); 
lastPlayer = nextPlayer(); 
// setBox(x, y, lastPlayer); 
setBox(new TicTacToeBean(1, x, y, lastPlayer)); 
if (isWin(x, y)) { 
return lastPlayer + " is the winner"; 
} else if (isDraw()) { 
return RESULT_DRAW; 
} else { 
return NO_WINNER; 
} 
} 


你 可 能 注意 到 了 ， 我 们 将 轮 次 设置 成 常量 1。 由 于 还 没有 规范 指定 要 以 其 他 方式 设置 轮 次 ， 
因此 这 里 采取 了 最 简单 的 方式 。 轮 次 的 问题 将 在 后 面 处 理 。 
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不 同 
时 间 


规范 





目 . A 稚 
征 心 公 








所 有 这 些 修改 都 非常 简单 ， 实现 起 来 所 需 的 时 间 很 得 。 如 果 修 改 的 范围 更 大 , 我 们 可 能 采取 























的 做 法 : 先 做 简单 的 修改 , 再 通过 重 构 实现 最 终 解决 方案 。 别 忘 了 速度 是 关键 ， 
纠缠 于 不 影响 测试 通过 的 实现 。 





6. 规范 





我 们 不 想 长 


如 果 无 法 保存 将 下 的 棋 ， 该 如 何 办 呢 ? 辅 助 方 法 saveMove 根 据 MongoDB 操 作 的 结果 返回 
true 或 ftalse， 而 我 们 可 能 想 在 它 返回 false 时 引发 异常 。 


先 做 重要 的 事情 。 我 们 应 修改 方法 before 的 实现 ， 确保 saveMove 默 认 返 回 true: 





@Before 
public final void before() 
throws UnknownHostException { 
collection = mock (TicTacToeCollection.class); 
doReturn (true) 
.when (collection) 
.SaveMove (any (TicTacToeBean.class)); 
ticTacToe = new TicTacToe (collection); 


} 








给 模拟 的 集合 指定 默认 行为 (在 saveMove 被 调用 时 返回 true ) 后 ， 便 可 以 接着 编写 这 个 





了 : 


@Test 
public void 
whenPlayAndSaveReturnsFalseThenThrowException() { 
doReturn(false) .when (collection). 
saveMove (any (TicTacToeBean.class)); 
TicTacToeBean move = 
new TicTacToeBean(1, 1, 3, “学 
exception.expect (RuntimeException. 二 
ticTacToe.play (move.getX(), move.getY()); 


’ 


} 




















我 们 使 用 Mockito 指 定 ，saveMove 被 调用 时 返回 false。 此 处 ， 我 们 不 关心 saveMove 具 体 





么 调用 的 ， 因此 向 它 传 递 参 数 any (1 ricTacToeBean.class)。 any() 也 是 一 


Mockito 方 法 。 





万 事 俱 备 后 ， 像 第 3 章 那 样 使 用 一 个 JUnit 异 常 。 





7. 实现 
下 面 做 简单 的 检查 ， 在 结果 不 符合 预期 时 引发 Runt imeException: 


private void setBox(TicTacToeBean bean) { 
if (board[bean.getXx() - 1l][bean.getY() - 1] 
Ls 0 
throw new RuntimeException( 
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"Box is occupied"); 


} else { 
board[bean.getxX() - 1l][bean.getY() - 1] = 
lastPlayer; 
// getTicTacToeCollection() .saveMove (bean); 


if (!getTicTacToeCollection() 
.SaveMove (bean)) { 
throw new RuntimeException( 
"Saving to DB failed"); 

















你 可 能 还 记得 ， 前 面 总 是 以 硬 编码 的 方式 将 轮 次 设置 为 1。 下 面 修复 这 个 问题 。 
我 们 可 以 调用 方法 play 两 次 ， 并 验证 轮 次 从 1 变 成 2: 


@Test 
public void 
whenPlayInvokedMultipleTimesThenTurnIncreases() { 
TicTacToeBean movel = 
new TicTacToeBean ( 
ticTacToe.play (movel .getxX( 
verify(collection, times(1 
TicTacToeBean move2 = 
new TicTacToeBean ( 
ticTacToe.play (move2 .getxX( 
verify(collection, times(1 


movel .getY()); 


de 
sy 
) ) .saveMove (movel);} 


move2 .getY()); 


pt 
2 
) ) .saveMove (move2 ) ; 





} 

9. 实现 

与 以 TDD 方 式 做 的 其 他 任何 事情 一 样 ， 实 现 也 非常 容易 : 
private int turn = 0; 


PUBLEe StElng Dlay (line Wr Tn yt 
checkAxis (x); 
checkAxis (y); 
lastPlayer = nextPlayer(); 
setBox(new TicTacToeBean (++turn, x, y, 
lastPlayer)); 
if (iswWin(x, y)) { 
return lastPlayer + " is the winner"; 
} else if (isDraw()) { 
return RESULT_DRAW; 
} else { 
return NO_WINNER; 
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10. 练习 

还 有 几 个 规范 及 其 实现 没有 完成 。 每 当 实 例 化 TicTacToe 类 时 ， 都 应 调用 方法 arop () ; 我 
们 还 应 确保 ，qrop () 返 回 false 时 引发 RuntimeException 异 常 。 这 些 规范 及 其 实现 就 作为 练 
习 留 给 你 去 完成 吧 。 

源 代 码 可 在 Git 仓 库 tdadq-java-ch06-tic-tac-toe-mongo 的 分 支 03-mongo ( https://bitbucket. 
org/vfarcic/tdd-java-ch06-tic-tac-toe-mongo/branch/03-mongo ) 中 找到 。 规 范 和 实现 类 分 别 为 
TicTacToeSpec 和 TicTacToe。 








6.5 ”集成 测试 


前 面 编写 了 大 量 单元 测试 ， 并 对 大 量 依赖 采取 了 信任 的 态度 。 我们 逐个 规范 并 实现 单元 ; 编 
写 规范 时 ,我 们 将 除 当 前 单元 外 的 东西 都 隔离 开 来 ,并 验证 单元 正确 调用 了 其 他 单元 。 然 而 , 现 
在 该 验证 所 有 这 些 单元 都 能 与 MongoDB 通 信 了 。 我 们 可 能 犯 了 错 ， 更 重要 的 是 ， 可 能 还 没有 让 
MongoDB 运 行 起 来 。 如果 部 署 应 用 程序 后 发 现 没 有 运行 这 个 数据 库 , 或 者 没有 正确 设置 配置 (IP、 
端口 等 )， 后 果 将 是 灾难 性 的 。 

你 可 能 猜 到 了 ,集成 测试 由 在 验证 各 个 组 件 、 应 用 程序 、 系 统 等 的 集成 情况 。 你 可 能 还 记得 
本 书 前 面 说 的 测试 金字 塔 , 它 指出 单元 测试 最 容易 编写 ， 运行 速度 也 最 快 。 因此 ,我们 应 仪 将 其 
他 类 型 的 测试 用 于 UT 未 覆盖 的 地 方 。 

我 们 应 将 集成 测试 分 离 出 来 , 以便 能 够 偶尔 运行 它们 (将 代码 加 入 仓库 前 或 作为 持续 集成 的 
一 部 分 )， 同 时 使 用 单元 测试 提供 持续 反馈 。 


































































































6.5.1 分 离 测 试 


如 果 遵 循 某 种 约定 ， 就 很 容易 在 Gradle 中 将 测试 分 离开 来 。 例 如 ， 我 们 可 以 将 测试 放 在 不 同 
的 目录 和 包 中 , 或 者 使 用 不 同 的 文件 名 后 级 。 此 处 选择 后 一 种 方法 : 对 于 所 有 规范 类 ， 给 它们 命 
名 时 都 加 上 后 级 spec( 如 TicTacToeSpec )。 我 们 可 以 制定 一 条 规则 ， 规 定 所 有 集成 测试 都 在 
名 称 中 使 用 后 缀 Integ。 


明白 这 一 点 后 ， 下 面 修改 文件 bui1d.gradle。 
首先 ， 我们 告诉 Gradle，test 任 务 应 只 使 用 名 称 以 spec 结 尾 的 类 : 


test { 

















include '**/*Spec.class' 
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接 下 来 ， 创 建 一 个 新 任务 


task testInteg(type: Test) { 
include '**/*Integ.class' 





testInteg.: 


} 


在 文件 bui1lg.gradle 中 添加 这 两 项 内 容 后 ， 我 们 依然 拥有 测试 任务 ， 这 些 任务 贯穿 本 书 ， 
但 现在 仅 限于 规范 (单元 测试 )。 另 外 ， 要 想 运 行 所 有 集成 测试 ， 可 在 IDEA 窗 口 Gradle projects 
中 单 击 任务 testInteg， 也 可 从 命令 提示 符 执行 如 下 命令 : 





gradle testIinteg 
下 面 编写 一 个 简单 的 集成 测试 。 
6.5.2 ”集成 测试 
包 com.packtpublishing.tddjava.ch03tictactoe 的 目录 src/test/java 下 ， 创建 一 


个 名 为 TicTacToeInteg 的 类 。 我 们 知道 ， 不 能 连接 到 数据 库 时 ，Jongo 将 引发 异常 。 因 此 这 个 
测试 类 可 以 很 简单 ， 如 下 所 示 : 








import org.junit.Test; 
import java.net .UnknownHostException; 
import static org.junit.Assert.*; 


public class TicTacToeInteg { 


@Test 
public void 
givenMongoDbIsRunningWhenPlayThenNoException () 
throws UnknownHostException { 
TicTacToe ticTacToe = new TicTacToe(); 
assertEquals (TicTacToe.NO_WINNER, 
ticTacToe.play (1, 1)); 





} 





调用 assertEquals 只 是 一 种 预防 措施 ,这 个 测试 的 真正 目标 是 确保 不 会 引发 异常 。 由 于 我 
们 没有 启动 MongoDB ( 除非 你 未 雨 绸 缪 ， 自 己 这 样 做 了 ; 如 果 是 这 样 ， 你 应 将 其 停止 ), 测试 将 
失败 。 
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x -~ Oo vfarcic@viktor: ~/ideaProjects/tdd-java-ch06-tic-tac-toe-mongo 


vfarcic@viktor:~/IdeaProjects/tdd-java-che6-tic-tac-toe-mongo$ gradle testInteg 
:CompiLeJava 
esources 


:CompiLeTest]Java 
:processTestResources 
:testClasses 
:testInteg 


com.packtpublishing.tddjava.che3tictactoe.TicTacToeInteg > givenMongoDbIsRunning 
WhenPLayThenNoException 


java.lang.RuntimeException at TicTacToeInteg.java:12 


1 test compLeted，1 faiLed 
:testInteg 


* What went wrong: 
Execution failed for task ':testInteg'. 

There were failing test See the report at: fitLe:///home/vfarcic/IdeapProjects 
/tdd-java-che6-tic-tac-toe-mongo/build/reports/tests/index.html 
ws 
Run with --stacktrace option to get the stack trace. Run with --tnfo or --debug 
option to get more Log output . 


Total time: 14.6 secs 
vfarcic@viktor:~/IdeaProjects/tdd-java-che6-tic-tac-toe-mongo$ | | 


知道 这 个 集成 测试 管用 ( 换言之，MongoDB 没 有 启动 时 它 确实 失败 了 ) 后 ,我 们 在 启动 
MongoDB 的 情况 下 再 次 运行 它 。 为 启动 MongoDB ， 使 用 Vagrant 创 建 一 个 使 用 操作 系统 Ubuntu 的 
虚拟 机 ， 并 将 MongoDB 作 为 docker 运 行 。 


请 确保 签 出 分 支 04-integration。 

















从 命令 提示 符 运行 如 下 命令 : 


$ vagrant up 
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请 耐心 等 待 VM 启动 完毕 ( 首次 执行 这 个 命令 时 可 能 需要 一 段 时 间 ， 连 接 带 宽 较 低 时 尤其 如 
此 )， 再 运行 集成 测试 。 











x ~ Oo vfarcic@viktor: ~/ideaProjects/tdd-java-ch06-tic-tac-toe-mongo 
vfarcic@viktor:~/IdeaProjects/tdd-java-che6-tic-tac-toe-mongo$ gradle testInteg 
:CompiLeJava 
:processResources 


:testInteg 


BUILD SUCCESSFUL 


Total time: 4.46 secs 
vfarcic@viktor:~/IdeaProjects/tdd-java-ch06-tic-tac-toe-mongo$ | 








测试 成 功 ， 现 在 我 们 深信 ， 确 实 成 功 集成 了 MongoDB。 


个 集成 测试 非常 简单 ， 实 际 工 作 中 需要 做 的 集成 测试 更 多 。 例 如 ， 我 们 可 能 查询 数据 库 ， 
ee 然而 ， 本 章 的 目的 是 让 你 学 会 如 何 模拟 ， 并 知道 不 能 完全 依赖 单元 测试 。 
下 一 章 将 更 深入 地 探讨 集成 测试 和 功能 测试 。 























可 在 Git 仓 库 tdd-java-ch06-tic-tac-toe-mongo 的 分 支 04-integration( https://bitbucket. 
org/vfarcic/ tdd-java-ch06-tic-tac-toe-mongo/branch/04-integration ) 中 找到 源 代 码 。 


6.6 小结 


模拟 和 监视 技术 用 于 隔离 其 他 代码 和 第 三 方 库 ， 需 要 快速 编写 代码 和 运行 测试 时 必 不 可 少 。 
如 果 不 使 用 模拟 对 象 ， 测 试 通常 将 复杂 得 难以 编写 ， 且 运行 速度 很 慢 ， 导 致 TDD 几 乎 无 法 进行 。 
测试 缓慢 意味 着 无 法 在 每 次 编写 新 规范 后 都 运行 所 有 测试 ， 这 将 导致 我 们 对 测试 的 信任 度 下 降 ， 
因为 只 运行 了 部 分 测试 。 

模拟 不 仅 是 一 种 很 有 用 的 外 部 依赖 隔离 方式 ， 还 可 将 你 自己 编写 的 代码 与 当前 单元 隔离 。 

本 章 介绍 了 Mockito， 在 我 们 看 来 ， 这 个 框架 在 平衡 功能 性 和 易 用 性 方面 是 最 好 的 。 建 议 你 
深入 研究 这 个 框架 的 文档 (http:/mockito.org/ ) 和 其 他 几 个 最 流行 的 Java 模 拟 框架 一 -EasyMock 


( http://easymock.org/ )、JMock (http:/www.jmock.org/ ) 和 PowerMock ( https://code.google.com/p/ 
powermock/ )。 
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“我 并 非 伟大 的 程序 员 ， 而 只 是 有 良好 习惯 的 优秀 程序 员 。” 


一 一 肯特 .贝克 
前 面 介绍 的 都 是 只 适用 于 开发 人 员 的 技巧 , 而 未 涉及 客户 、 业 务 代表 和 其 他 无 法 理解 代码 的 
相关 方 。 
TDD 涉 及 的 范围 比 我 们 前 面 所 做 的 大 得 多 。 我们 可 定义 需求 , 与 客户 讨论 需求 并 就 开发 内 容 
达成 一 致 ; 我 们 可 以 将 这 些 需求 变 成 可 执行 的 ,以 驱动 和 验证 开发 工作 ; 我 们 可 使 用 普通 语言 5 
写 验收 测试 。 所 有 这 些 以 及 其 他 任务 都 可 使 用 名 为 行为 驱动 开发 (BDD ) 的 TDD 变 种 完成 。 


我 们 将 使 用 BDD 方 法 开发 一 个 书店 应 用 程序 : 使 用 自然 语言 定义 验收 测试 ， 分 别 创建 每 项 
功能 的 实现 ， 通 过 运行 BDD 场 景 确认 它们 能 够 正常 工作 ， 并 在 必要 时 重 构 代码 以 达到 要 求 的 质 
量 等 级 。 这 个 过 程 中 ,我们 依然 采用 “ 红 灯 - 绿 灯 -- 重 构 ” 流 程 ， 这 是 TDD 的 精髓 所 在 。 主 要 差 
别 在 于 定义 层面 : 前 面 我 们 几乎 都 在 单元 层面 工作 ， 这 次 将 稍微 上 移 ， 将 TDD 应 用 于 功能 测试 
和 集成 测试 。 


我 们 选择 的 框架 为 JBehave 和 Selenide。 
本 章 涵盖 如 下 主题 : 


口 不 同文 档 ; 

口 行为 驱动 开发 ; 

口 书店 应 用 程序 的 BDD 故 事 ; 
口 JBehave。 




































































7.1 不 同 规范 


前 面 说 过 , TDD 的 好 处 之 一 是 ， 可 执行 文档 始终 是 最 新 的 。 然 而 , 仅 有 通过 单元 测试 获得 的 
文档 还 不 够 ; 在 单元 这 个 很 低 的 层面 工作 时 ,我 们 对 细节 洞 若 观 火 ， 但 很 容易 “只 见 树木 , 不 见 
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森林 ”。 例如， 如 果 我 们 审视 为 “ 井 字 游 戏 ” 创 建 的 规范 ， 很 可 能 领会 不 到 这 个 应 用 程序 的 要 点 : 
你 明白 每 个 单元 的 功能 ,也 知道 它 是 如 何 与 其 他 单元 互 操作 的 , 却 难以 掌握 其 背后 的 理念 。 更 准 
确 地 说 ， 你 知道 单元 X 做 的 事情 是 Y， 并 与 单元 Z 通 信 ， 却 难以 找到 功能 文档 及 其 背后 的 理念 。 

对 开发 来 说 亦 是 如 此 。 要 着 手 处 理 表现 为 单元 测试 的 规范 ,我们 需要 对 系统 有 更 全 面 的 了 解 。 
本 书 前 面 都 先 列 出 需求 ， 再 根据 需求 编写 规范 ， 然 后 根据 规范 编写 实现 。 随 后 ， 这 些 需求 都 被 丢 
弃 ， 查 无 音信 。 我 们 没有 将 它们 放 入 仓库 ， 也 没有 根据 它们 验证 工作 成 果 。 



























































7.1.1 文档 


我 们 合作 过 的 很 多 组 织 中 , 创建 文档 的 出 发 点 就 是 错误 的 。 管理 层 通常 认为 文档 与 项 目 成 败 
有 一 定 关系 ， 如 果 没 有 大 量 ( 通常 是 短命 的 ) 文档 , 项 目 就 会 失败 。 因 此 ， 大 家 被 要 求 花 大 量 时 
间 进 行规 划 、 回 答 问题 以 及 填写 问卷 ， 而 这 些 问 卷 的 设计 常常 对 项 目 毫 无 帮助 , 却 旨 在 营造 “一 
切 尽 在 掌握 ”的 假象 。 有 些 职位 就 是 为 文档 而 存在 的 一 一 这 个 文档 就 是 我 的 工作 成 果 。 文 档 还 被 
作为 安奈 剂 ， 让 人 觉得 一 切 都 在 按 计划 进行 一 -有 Excel 表 指出 了 这 一 点 。 然 而 ， 创 建文 档 最 常 
见 的 原因 是 ， 有 规章 制度 要 求 必须 创建 某 些 文档 ; 即便 你 怀疑 这 些 文档 的 价值 ， 但 规章 制度 神圣 
不 可 侵犯 ， 你 必须 创建 。 


文档 不 仅 可 能 以 错误 的 目的 创建 ,从 而 不 能 提供 足够 的 价值 , 而且 常常 可 能 有 巨大 的 破坏 力 。 
既然 创建 了 文档 ， 自 然 要 信任 它 ， 可 如 果 文 档 不 是 最 新 的 ， 结 果 将 如 何 呢 ? 需 求 在 变化 ， 有 bug 
得 到 修复 ， 有 新 功能 被 开发 ， 还 有 一 些 既 有 功能 被 删除 。 


只 要 时 间 足 够 长 ,所 有 传统 文档 都 将 过 时 。 每 次 修改 代码 都 更 新 文档 是 项 庞大 而 复杂 的 任务 ， 
因此 述 早 会 出 现 静 态 文 档 没 有 反映 实际 情况 的 问题 。 如 果 我 们 完全 信任 不 准确 的 东西 , 开发 工作 
基于 的 假设 就 将 是 错误 的 。 

唯一 准确 的 文档 是 我 们 编写 的 代码 。 代 码 是 我 们 开发 的 ,也 是 我 们 部 署 的 ， 只 有 它们 才 
全 准确 反映 应 用 程序 。 然 而 ， 并非 参与 项 目的 每 个 人 都 能 读 懂 代码 ， 除 程序 员外 ,我 们 还 可 
要 与 管理 人 员 、 测 试 人 员 、 业 务 人 员 、 最 终 用 户 等 合作 。 

为 更 准确 地 确定 什么 样 的 文档 更 好 ,下 面 深入 研究 潜在 的 文档 使 用 者 。 为 简单 起 见 , 我 们 将 
这 些 文档 使 用 者 分 为 两 类 : 程序 员 (能够 阅读 并 理解 代码 的 使 用 者 ) 和 非 程序 员 ( 其 他 使 用 者 )。 
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7.1.2 ” 供 程序 员 使 用 的 文档 

开发 人 员 与 代码 打交道 ， 鉴 于 我 们 已 确定 代码 是 最 准确 的 文档 ， 因 此 没有 理由 不 使 用 它们 。 
如 果 你 要 搞 明 白 某 个 方法 是 做 什么 的 , 请 看 这 个 方法 的 代码 。 对 某 个 类 的 作用 心 存疑 惑 ? 请 看 这 
个 类 的 代码 。 有 一 段 代码 看 不 明白 ?这 就 麻烦 了 ! 然而 ， 导 致 这 种 麻烦 的 不 是 文档 缺失 ， 而 是 代 
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码 本 身 写 得 不 好 。 


仅 通过 研究 以 理解 代码 通常 还 不 够 。 即 便 你 明白 了 代码 是 做 什么 的 ， 其 目的 也 可 能 不 明显 : 
最 初 为 何 要 编写 这 些 代 码 呢 ? 


此 时 ,规范 便 可 派 上 用 场 。 我 们 不 仅 不 断 使 用 规范 以 验证 代码 ,它们 还 是 可 执行 的 文档 。 规 
范 总 是 最 新 的 ， 否则 它们 执行 时 就 会 失败 。 男 外 ,虽然 代码 应 该 编写 得 易于 阅读 和 理解 ,但 帮助 
理解 某 段 实现 代码 的 编写 原因 、 人 逻辑 和 动机 方面 ， 规范 提供 了 更 容易 的 捷径 。 


将 代码 作为 文档 并 不 排斥 其 他 类 型 的 文档 。 恰恰 相反 ,关键 不 是 避免 使 用 静态 文档 ， 而 是 避 
免 重 复 。 代 码 提供 了 必要 的 细节 时 ,优先 查看 代码 而 不 是 其 他 文档 ; 大 多 数 情 况 下 ， 其 他 文档 指 
的 是 较 简略 的 文档 ， 如 概述 、 系 统 的 总 体 目 标 、 使 用 的 技术 、 环 境 搭建 、 安 装 、 构 建 、 打 包 以 及 
其 他 类 型 的 数据 。 它 们 不 提供 详细 信息 ， 更 像 是 指南 和 快速 入 门 。 对 于 这 些 文档 ，markdown 格 
式 (http://whatismarkdown.com/ ) 的 简单 README 文 件 通常 是 最 佳 的 。 


对 于 基于 代码 的 文档 TDD 是 最 佳 的 创建 方式 。 到 目前 位 置 , 我们 都 是 在 单元 (方法 ) 级 工 
作 ， 还 没有 在 更 高 层面 ( 如 功能 规范 ) 应 用 TDD， 但 这 样 做 之 前 ， 先 看 看 团队 中 的 其 他 角色 。 








































































































































































































7.1.3 ” 供 非 程序 员 使 用 的 文档 


传统 测试 人 员 通 常 与 开发 人 员 归 属于 完全 不 同 的 小 组 ， 这 种 划分 导致 更 多 测试 人 员 不 熟悉 
代码 ， 并 认为 自己 做 的 是 质量 检查 工作 。 他 们 是 流程 末端 的 检验 员 ， 像 边防 警察 一 样 决定 哪些 
代码 可 以 部 署 、 哪 些 需要 返工 。 另 一 方面 ， 越 来 越 多 的 组 织 将 测试 人 员 视 为 开发 团队 的 一 员 ， 
其 职责 是 确保 软件 的 内 生 质 量 。 这 类 测试 人 员 必 须 熟 悉 代 码 ， 对 他 们 来 说 ， 将 代码 作为 文档 再 
自然 不 过 。 然 而 ， 对 于 第 一 类 测试 人 员 ( 即 不 懂 代 码 的 测试 人 员 ), 该 如 何 办 呢 ? 男 外 ， 并非 只 
有 一 些 测 试 人 员 不 懂 代 码 ， 管 理 人 员 、 最 终 用 户 、 业 务 代表 等 也 不 懂 代 码 。 无 法 阅读 并 理解 代 
码 的 人 到 处 都 是 。 

我 们 需要 寻找 一 种 方式 保留 可 执行 的 文档 提供 的 优点 ,同时 以 人 人 都 能 理解 的 方式 编写 。 另 
外 , 在 TDD 中 , 应 该 从 一 开始 创建 可 执行 文档 时 ， 就 让 所 有 人 都 参与 : 让 他 们 定义 用 于 开发 应 用 
程序 和 验证 开发 成 果 的 需求 。 我 们 需要 指定 将 做 什么 的 简略 规范 , 因为 详尽 规范 由 单元 测试 提供 。 
总 之 ， 我 们 需要 这 样 的 文档 : 可 作为 需求 ， 可 执行 ， 可 对 工作 进行 验证 ， 人 人 都 能 编写 和 理解 。 


下 面 介绍 行为 驱动 开发 。 



























































7.2 行为 驱动 开发 


BDD 是 一 种 敏捷 过 程 ， 骨 在 项 目 开发 过 程 中 始终 专注 于 相关 方 的 利益 。 这 是 一 个 TDD 变 种 ， 
它 也 预先 定义 规范 ， 根 据 规范 完成 实现 并 定期 运行 规范 以 验证 结果 。 此 外 ， 还 有 一 些 不 同 之 处 。 
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不 像 TDD 那 样 基于 单元 测试 ，BDD 倡 导 编 写 多 个 规范 〈 称 为 场景 ) 再 开始 实现 ( 编码 )。 虽然 没 
有 具体 的 规则 ， 但 BDD 通 常 偏重 于 简约 的 功能 需求 。BDD 虽 然 可 用 于 单元 层面 ， 但 仅 当 采用 人 
人 都 能 编写 和 理解 的 简略 方法 时 , 才能 得 到 实际 好 处 。 另 一 个 不 同 之 处 是 受众 : BDD 适 用 于 所 有 
人 一 一 程序 员 、 测 试 人 员 、 管 理 人 员 、 最 终 用 户 、 业 务 代 表 等 。TDD 基 于 单元 层级 ， 可 以 说 是 从 
内 到 外 的 〈 从 单元 开始 ， 逐 步 延 伸 到 功能 )， 而 BDD 通 常 被 认为 是 从 外 到 内 的 〈 从 功能 着 手 ， 往 
内 逐步 延伸 到 单元 ), 行为 驱动 开发 扮演 的 是 验收 标准 和 就 绪 程度 指示 顺 的 角色 ， 指 出 产品 何 时 
完工 并 可 部 署 到 生产 环境 。 


我 们 首先 定义 功能 (或 行为 ), 再 使 用 TDD 和 单元 测试 实现 ; 实现 完整 的 行为 后 , 再 使 用 BDD 
验证 。 一 个 BDD 场 景 可 能 需要 几 小 时 乃至 几 天 才能 完成 , 在 此 期 间 , 我 们 可 使 用 TDD 和 单元 测试 。 
完成 后 ， 运 行 BDD 场 景 做 最 后 的 验证 。TDD 是 针对 程序 员 的 ， 周 期 非常 短 ; 而 BDD 针 对 所 有 人 ， 
周期 要 长 得 多 。 对 于 每 个 BDD 场 景 ， 都 有 大 量 TDD 单 元 测试 。 


此 时 你 可 能 一 头 雾 水 , 不 知道 BDD 到 底 为 何 物 。 有 鉴于 此 ,下面 对 其 进行 详细 介绍 ， 首 先 解 

























































































7.2.1 叙述 


BDD 故 事由 叙述 (narrative ) 和 至 少 一 个 紧 跟 其 后 的 场景 组 成 。 叙 述 只 起 说 明 作 用 ， 其 主要 
用 途 是 提供 足够 的 信息 ， 为 参与 各 方 (测试 人 员 、 业 务 代表 、 开 发 人 员 、 分 析 人 员 等 ) 深入 交流 
打 基 础 。 叙 述 简短 地 描述 一 个 功能 ， 这 种 描述 是 从 要 求 提 供 该 功能 的 人 的 角度 进行 的 。 


叙述 的 目标 是 回答 如 下 三 个 基本 问题 : 


(1) 要 开发 的 功能 的 好 处 或 价值 (Im order to ) ? 
(2) 谁 需要 这 项 功能 (Asa) ? 
(3) 要 开发 什么 样 的 功能 (Iwantto ) ? 


回答 这 些 问题 后 , 开始 着 手 定 义 我 们 认为 的 最 佳 解决 方案 。 这 种 思维 过 程 的 结果 是 提供 详细 
信息 的 场景 。 


目前 为 止 , 我 们 都 在 非常 低 的 层级 工作 ,并 将 单元 测试 作为 驱动 力 。 我 们 从 程序 员 的 角度 指 
定 要 创建 什么 ; 假定 高 级 需求 已 定义 好 ， 而 我 们 的 职责 是 根据 需求 编写 代码 。 现 在 回 到 开头 ， 变 
身 为 客户 或 业务 代表 : 有 人 出 了 一 个 绝妙 的 点 子 ， 而 我 们 正 与 团队 的 其 他 成 员 讨 论 这 个 点 子 。 简 
而 言 之 , 我 们 想 打 造 一 个 网 上 书店 ; 当前 还 处 于 设想 阶段 ,我 们 甚至 都 不 确定 将 如 何 开发 ， 因 此 
想 开 发 一 个 最 小 可 行 产 品 (MVP )。 我 们 要 研究 的 一 个 角色 是 书店 管理 员 ， 他 应 能 够 添加 新 书 以 
及 更 新 或 删除 既 有 图 书 。 所 有 这 些 操 作 都 应 该 是 可 执行 的 ， 因为 我 们 希望 管理 员 能 够 高 效 管理 书 
店 的 图 书 。 对 于 这 个 角色 ， 我 们 提出 的 叙述 如 下 : 
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为 了 高 效 管理 书店 

作为 书店 管理 页 

硕 望 能 够 添加 、 更 新 、 删 除 图 书 

至 此 ， 我 们 知道 了 好 处 是 什么 〈 高 效 管理 图 书 )、 谁 需要 (管理 员 ) 以 及 需要 开发 什么 样 的 
功能 (插入 、 更 新 和 删除 操作 )。 别 忘 了 ， 这 并 非 有 关 我 们 该 做 什么 的 详尽 描述 。 倒 述 旨 在 发 起 
讨论 ， 这 种 讨论 的 结果 是 一 个 或 更 多 场景 。 


不 同 于 TDD 单 元 测试 , 叙述 以 及 BDD 故 事 的 其 他 部 分 是 任何 人 都 能 够 编写 的 。 它们 不 要 求 纺 
写 者 有 编程 技能 , 也 不 需要 太 详细 。 根据 所 在 的 组 织 , 可 能 由 同一 个 人 (业务 代表 、 产 品 所 有 者 、 
客户 等 ) 编写 所 有 叙述 ， 也 可 能 由 整个 团队 协作 编写 。 


对 叙述 有 更 清晰 的 认识 后 ， 下 面 看 看 场景 。 




































































7.2.2 场景 


叙述 则 在 促进 交流 ， 而 场景 是 交流 的 结果 。 场景 应 描述 (As a 部 分 指定 的 ) 角色 与 系统 的 交 
互 。 单 元 测试 是 开发 人 员 编 写 的 代码 , 供 开发 人 员 使 用 ; BDD 场 景 与 此 不 同 ,它们 应 使 用 平实 的 
语言 定义 , 并 包含 尽 可 能 少 的 技术 细节 , 让 项 目的 所 有 参与 者 (开发 人 员 、 测试 人 员 、 设计 人 员 、 
管理 人 员 、 客 户 等 ) 能 针对 要 在 系统 中 添加 哪些 行为 (或 功能 ) 达成 一 致 。 

场景 是 叙述 的 验收 标准 。 只 要 与 叙述 相关 的 场景 都 能 成 功 运 行 ， 就 可 认为 工作 完成 。 场 景 
与 单元 测试 很 像 , 主要 差别 在 于 涵盖 的 范围 (一 个 方法 还 是 整个 功能 ) 以 及 实现 所 需 的 时 间 ( 几 
秒 钟 、 几 分 钟 还 是 几 小 时 力 至 几 天 ), 与 单元 测试 类 似 , 场景 也 用 于 驱动 开发 ， 是 在 开发 之 前 定 
义 的 。 

每 个 场景 都 包含 一 个 描 述 ， 还 有 一 个 或 多 个 以 Given 、When 或 Then 开 始 的 步骤 。 描 述 很 短 ，， 
只 是 为 了 提供 一 些 信息 ， 让 我 们 能 够 迅速 明白 场景 的 目的 。 另 一 方面 ,步骤 是 场景 的 一 系列 前 置 
条 件 、 事 件 和 期 望 结果 ; 它们 帮助 我 们 明确 定义 行为 ， 可 轻松 转换 为 自动 化 测试 。 

本 章 将 更 多 专注 于 BDD 的 技术 方面 及 其 对 开发 人 员 心 态 的 影响 。 有 关 BDD 更 广泛 的 用 途 和 
更 深入 的 讨论 ， 参 阅 Gojko Adzic 的 著作 《实例 化 需求 : 团队 如 何 交 付 正确 的 软件 》。 


Given 步 又 定义 了 上 下 文 ， 即 为 让 场景 的 其 他 部 分 获得 成 功 而 需要 满足 的 前 置 条 件 。 根 据 前 
面 有 关 图 书 管理 的 叙述 ， 一 个 这 样 的 前 置 条 件 可 能 如 下 所 示 : 

Given 用 户 当前 在 图 书页 面 

这 个 前 置 条 件 很 简单 ,但 必 不 可 少 。 我 们 的 网 站 可 能 有 很 多 页 面 ， 因 此 执行 任何 操作 前 ,都 
需 确 保 用 户 位 于 正确 的 页 面 。 


When 步骤 定义 了 操作 或 某 种 事件 。 前 面 的 叙述 中 ， 我 们 指定 了 管理 员 必 须 能 够 添加 、 更 新 
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和 删除 图 书 。 下 面 看 看 与 删除 相关 的 操作 : 


When 用 户 选 择 一 本 书 

When 用 户 点 击 删 除 按 钮 

这 个 示例 中 ,我 们 使 用 When 步骤 定义 了 多 个 操作 : 先 选 择 一 本 书 ,再 单 击 按钮 Delete the book。 
在 这 里 ， 我 们 指定 要 单 击 的 按钮 时 ， 使 用 的 是 ID (deleteBook ) 而 不 是 文本 ( Delete the book )。 
大 多 数 情况 下 ， 使 用 ID 更 好 ， 因 为 ID 有 多 个 优点 : 它们 是 独一无二 的 (在 给 定 页 面 中 ， 每 个 ID 
只 能 出 现 一 次 ); 它们 向 开发 人 员 发 出 了 更 明确 的 指令 (创建 一 个 ID 为 deleteBook 的 元 素 ); 它们 
不 受 当 前 页 面 上 其 他 变化 的 影响 。 元 素 的 文本 很 容易 发 生变 化 ; 而 元 素 文本 发 生变 化 后 ,所 有 使 
用 它 的 场景 也 将 失败 。 就 网 站 而 言 ， 另 一 种 指定 元 素 的 方式 是 使 用 XPath， 但 应 尽 可 能 避免 这 样 
做 。 因 为 只 要 HTML 结 构 发 生 细微 的 变化 ， 指 定 的 XPath 就 不 再 正确 。 

与 单元 测试 类 似 ， 场 景 也 应 是 可 靠 的 ,并 在 功能 没有 实现 或 发 生 问 题 时 失败 。 和 否则 ， 当 它们 
出 现 漏 报 问 题 后 ， 大 家 自然 就 会 对 规范 置 知 回 闻 。 

最 后 , 我 们 应 该 总 是 在 场景 末尾 包含 验证 , 应 该 指定 操作 的 期 望 结 果 。 在 前 面 的 场景 中 , Then 
步骤 可 能 如 下 所 示 : 

Then 图 书 已 被 删除 


这 里 定义 的 结果 做 了 很 好 的 折衷: 既 提 供 了 足够 的 信息 ， 又 未 涉及 设计 细节 。 我 们 原本 可 以 
提 及 数据 库 ， 甚 至 具体 到 MongoDB 数 据 库 。 然 而 ， 很 多 情况 下 ， 这 种 信息 从 行为 角度 看 都 不 重 
要 。 我 们 应 只 确认 图 书 从 目录 中 删除 了 ， 而 不 管 它 存储 在 什么 地 方 。 


熟悉 BDD 故 事 的 格式 后 ， 下 面 编写 书店 应 用 程序 的 BDD 故 事 。 





































































































7.3 书店 应 用 程序 的 BDD 故事 


首先 ， 复 制 https://bitbucket.org/vfarcic/tdd-java-ch07-books-store 处 的 代码 。 这 是 一 个 空 项 目 ， 
本 章 将 始终 使 用 它 。 与 前 几 章 一 样 ， 每 节 都 在 这 个 仓库 中 有 对 应 的 分 支 ， 以 免 遗 漏 。 


我 们 将 编写 一 个 BDD 故 事 ， 它 是 纯 文本 的 ,使 用 的 是 普通 英语 ， 且 不 包含 任何 代码 。 这 样 ， 
所 有 利益 相关 方 都 能 参与 ， 而 不 管 其 编码 水 平 如 何 。 本 章 后 面 将 演示 如 何 自动 化 这 个 故事 。 


先 在 目录 stories 中 新 建 一 个 aqministration.story 文 件 。 
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e Edit View Navigat 
tdd-java-ch07-boo 


Jject 
tdd-java-ch07-books-store 
令 .gitignore 

x D New File 





前 面 已 经 编写 了 叙述 ， 因 此 我 们 将 接着 这 个 叙述 往 下 编写 。 


叙述 : 


为 了 高 效 管理 书店 
作为 书店 管理 员 
希望 能 够 添加 、 更 新 、 删 除 图 书 





我 们 将 使 用 JBehave 格 式 编 写 故 事 。 有 关 JBehave 的 更 多 细节 将 稍 后 介绍 ， 届 时 请 访问 
http://jbehave.org/ 获 取 更 多 信息 。 




















叙述 都 以 Narrative 行 打头 ,后 面 跟 着 In order to、As a 和 I want to 行 ， 这 几 行 的 含 
义 前 面 已 经 讨论 过 。 








知道 为 何 、 











是 谁 和 什么 后 , 该 与 团队 的 其 他 人 员 一 起 坐 下 来 讨论 可 能 的 场景 了 。 此 时 我 们 不 





讨论 步骤 ( Given、When 和 Then )， 而 只 对 潜在 场景 做 简要 描述 。 这 些 场景 可 能 是 如 下 所 示 : 


Scenario: 
Scenario: 
Scenario: 
Scenario: 
Scenario: 


图 书 细 节 表 单 应 当 拥有 全 部 字段 
用 户 应 当 可 以 创建 一 本 新 书 

用 户 应 当 可 以 展示 图 书 细节 

用 户 应 当 可 以 更 新 图 书 细节 

用 户 应 当 可 以 删除 图 书 





这 里 使 用 的 是 JBehave 语 法 : 先 写 出 单词 Scenario， 再 做 简短 的 描述 。 这 个 阶段 没有 理由 涉及 
细节 ， 旨 在 进行 快速 头脑 风暴 。 在 这 里 ,我 们 想 出 了 5 个 场景 ， 其 中 第 一 个 定义 了 将 用 于 管理 图 
书 的 表单 字段 ， 而 其 他 场景 试图 定义 各 种 管理 任务 。 这 些 场景 真 的 没什么 创意 可 言 。 我 们 要 做 的 
































是 开发 一 个 非常 简单 的 应 用 程序 的 MVP, 如 果 结 果 表 明 这 个 产品 很 成 功 , 我 们 就 可 发 挥 创 意 对 其 


进行 扩展 。 就 当前 目标 而 言 ， 这 个 应 用 程序 将 十 分 简单 直 白 。 
知道 场景 都 是 什么 后 ， 该 对 它们 做 正确 而 简要 的 定义 了 。 从 第 一 个 场景 着 手 : 


Scenario: 图 书 细节 表单 应 当 拥 有 全 部 字段 
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Given 用 户 当前 在 图 书页 面 

Then 字段 bookTIdq 存 在 

Then 字段 pookTiLt1e 存 在 

Then 字段 pookAuthor 存 在 

Then 字段 pookDescription 存 在 


世 景 没有 包含 任何 操作 一 一 没有 When 步骤 ,可 将 其 视 为 完整 性 检查 。 它 告诉 开发 人 员 ， 








a 包含 哪些 字段 。 根 据 这 些 字段 ， 可 确定 要 使 用 的 数据 模式 ( schema 这 些 ID 的 描述 
性 足够 强 ， 让 我 们 知道 每 个 字段 都 是 做 什么 的 (一 个 图 书 ID 和 三 个 文本 字段 )。 别 忘 了 ， 这 个 场 


景 ( 


以 及 后 续 所 有 场景 ) 都 是 纯 文本 的 , 不 包含 任何 代码 。 这 种 场景 的 主要 优点 是 谁 都 能 够 编写 ， 


我 们 将 尽力 坚持 这 种 做 法 。 


下 面 看 看 第 二 个 场景 : 
Scenario: 用 户 应 当 可 以 创建 一 本 新 书 


Given 用 户 当前 在 图 书页 面 
When 用 户 点 击 newBook 按 鱼 
When 用 户 为 图 书 表 单 设置 值 
When 用 户 点 击 SaveBook 按 钮 
Then 保存 图 书 


这 个 场景 比 前 一 个 更 正规 ， 其 中 有 一 个 明确 的 前 置 条 件 〈 用 户 访问 的 是 特定 页 面 )， 有 多 个 








操作 ( 单 击 按钮 newBook、 填 写 表单 并 单 击 按钮 saveBook )， 还 有 结果 验证 〈 保存 图 书 )。 





其 他 场景 如 下 (这些 场景 都 与 前 面 的 场景 类 似 ， 因 此 没有 必要 分 别 解释 ): 


Scenario: 用 户 应 当 可 以 展示 图 书 细节 





Given 用 户 当 前 在 图 书页 面 
When 用 户 选择 一 本 书 
Then 图 书 表单 包含 所 有 数据 


Scenario: 用 户 应 当 可 以 更 新 图 书 细节 


Given 用 户 当前 在 图 书页 面 
When 用 户 选 择 一 本 书 
When 用 户 为 图 书 表 单 设 置 值 
Then 保存 图 书 











Scenario: 用 户 应 当 可 以 删除 图 书 


Given 用 户 当前 在 图 书页 面 
When 用 户 选 择 一 本 图 书 

When 用 户 点 击 deleteBook 按 鱼 
Then 删除 图 书 


唯一 需要 指出 的 一 点 是 , 我 们 在 合适 的 情况 下 使 用 了 相同 步 又 ( 如 When 用 户 选 择 一 本 图 书 )。 











稍 后 将 尝试 自动 化 所 有 场景 , 通过 在 相同 步 又 中 使 用 相同 文本 , 可 避免 复制 代码 , 从 而 节省 时 间 。 





我 1 


门 必须 在 以 最 佳 方式 自由 表达 场景 和 简化 自动 化 之 间 取 得 平衡 , 这 很 重要 。 这 些 场景 还 有 一 些 
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可 修改 的 地 方 ， 但 对 它们 进行 重 构 前 ， 先 简要 介绍 JBehave。 


可 在 Git 仓 库 taqd-java-ch07-books-store 的 分 支 00-story ( https://bitbucket.org/vfarcic/ 
tdd-java-ch07-books-store/branch/00-story ) 中 找到 源 代 码 。 


7.4 JBehave 


要 让 JBehave 能 够 运行 BDD 故 事 ， 必 须 有 两 个 主要 的 组 件 : 运行 器 和 步 又。 运行 器 是 一 个 类 ， 
它 对 故事 进行 分 析 , 运行 所 有 场景 并 生成 报告 ; 步骤 则 是 与 场景 中 步骤 匹配 的 代码 方法 。 本 章 的 
项 目 已 经 包含 所 有 Gradle 依 赖 ， 因 此 可 以 直接 创建 了 eehave 运 行 器 。 











7.4.1 JBehave 运行 器 


每 种 类 型 的 测试 都 需要 一 个 运行 器 ，JBehave 中 也 不 例外 。 前 几 章 中 ， 我 们 使 用 了 JUnit 和 
TestNG 运 行 器 。 这 些 框架 中 都 不 需要 做 特殊 配置 ， 但 JBehave 的 更 苛刻 ， 要 求 我 们 必须 创建 一 个 
类 ， 用 于 存储 运行 故事 所 需 的 所 有 配置 。 


下 面 是 贯穿 本 章 都 将 使 用 的 Runner 类 的 代码 : 

















public class Runner extends JUnitStories { 


@Override 
public Configuration configuration() { 
return new MostUsefulConfiguration() 
.USeStoryReporterBuilder (getReporter () ) 
.USeStoryLoader (new LoadFromURL()); 


} 


@Override 
protected List<String> storyPaths() { 
String path = "stories/**/*, Story"; 
return new StoryFinder() .findqPaths( 
CodeLocations 
.CodeLocationFromPpath("") 
.getFile(), 
Collections 
.SingletonList (path), 
new ArrayList<String>(), 
下 





} 


@Override 
public InjectableStepsFactory stepsFactory() { 
return new InstanceStepsFactory ( 
configuration(), 
new Steps () 
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} 


private StoryReporterBuilder getReporter() { 
return new StoryReporterBuilder () 
.withPpathResolver\( 
new FilePrintStreamFactory 
.ResolveToSimpleName () 
) 
.withDefaultFormats () 
.withFormats (Format .CONSOLE, Format .HTML); 


} 

这 些 代码 很 平常 ， 因 此 只 解释 其 中 的 几 个 重要 部 分 。 重 写 的 方法 storyPaths 将 故事 文件 的 
位 置 设置 为 stories/**/*.story， 这 是 一 种 标准 的 Apache Ant ( http://ant.apache.org/ ) 语法 。 
用 通俗 的 语言 说 ， 这 意味 着 包含 目录 stories 及 其 所 有 子 目 录 (** ) 中 所 有 扩展 名 为 .story 的 
文件 。 另 一 个 重要 的 重 写 方 法 是 stepsFactory， 它 用 于 设置 包含 步 又 定义 的 类 (我 们 马上 就 会 
编写 它 )。 在 这 里 ， 我 们 将 其 设置 为 Steps 类 的 实例 (仓库 包含 一 个 我 们 将 在 后 面 使 用 的 空 类 )。 
























































可 在 Git 仓 库 tagd-java-ch07-books-store 的 分 支 01-runner( https://bitbucket.org/vfarcic/ 
tdd-java-ch07-books-store/branch/01-runner ) 中 找到 源 代码 。 


写 运行 器 代码 后 ， 启 动 并 查看 结果 。 





诗 

















7.4.2 ”待定 步骤 


可 使 用 下 面 的 Gradle 命 令 运行 场景 : 

$ gradle clean test 

Gradle 只 运行 前 一 次 执行 后 修改 过 的 任务 。 由 于 源 代码 变化 不 频繁 ( 我们 通常 只 修改 文本 格 
式 的 故事 )， 因 此 运行 Lest 任 务 前 ， 必 须 运 行 clean 任 务 将 缓存 删除 。 

JBehave 创 建 了 一 个 不 错 的 报告 ， 并 将 其 放 在 日 录 target /jbehave/view 中 。 请 使 用 你 喜 
欢 的 浏览 器 打开 这 个 目录 中 的 文件 reports .html。 

报告 的 第 一 页 列 出 了 我 们 定义 的 故事 ( 这 里 只 有 故事 Administration )， 还 有 两 个 预定 义 的 故 
事 一 一 BeforeStories 和 AfterStories 。 这 两 个 故事 的 用 途 与 JUnit 中 用 @Beforeclass 和 
@Afterclass 注 解 的 方法 类 似 : 在 故事 之 前 和 之 后 运行 ， 可 用 于 设置 和 拆除 数据 、 服 务 器 等 。 

报告 的 第 一 页 表明 , 我 们 有 5 个 场景 ,它们 都 处 于 待定 ( Pending ) 状态 。JBehave 通 过 这 种 方 
式 告诉 我 们 ， 场 景 既 未 成 功 也 未 失败 ， 而 是 使 用 过 的 步骤 缺失 代码 。 












































图 灵 社 区 会 员 yasenluobinh(yasenluobinhappy@163.com) 专 享 尊重 版 权 








A 


138 第 7 章 BDD 一 一 与 整个 团队 协作 





Story Reports 


Name Excluded | Total Successful Pending Failed Excluded 


Administration 


AfterStories 


BeforeStories 








3 




















Ye 


每 行 的 最 后 一 列 都 包含 一 个 链接 ， 让 我 们 能 够 查看 相应 故事 的 详情 。 





Narrative: 


In order to manage the book store collection 
As a store administrator 


| want to be able to perform insert, update and delete operations 


Scenario: Book details form should have all fields 


Given user is on the books screen (PENDING) 
Then field bookld exists (PENDING) 

Then field bookTitle exists (PENDING) 

Then field bookAuthor exists (PENDING) 
Then field bookDescription exists (PENDING) 


@Given("user is on the books screen") 

@Pending 

public void givenUserIsOnTheBooksScreen() { 
// PENDING 

} 











在 这 里 ， 所 有 步骤 都 被 标记 为 “待定 ”，JBehave 甚 至 提出 了 建议 ， 指 出 需要 为 每 个 待定 步 又 
创建 一 个 方法 。 











目前 为 止 ， 我 们 编写 一 个 包含 5 个 场景 的 故事 。 每 个 场景 都 相当 于 一 个 规范 ， 用 于 指定 我 们 
应 开发 什么 以 及 验证 是 否 正确 完成 了 开发 。 这 些 场景 都 包含 多 个 定义 前 置 条 件 (Given )、 操 作 
(When ) 和 期 望 结果 ( Then ) 的 步骤 。 





现在 编写 步 又 背后 的 代码 ， 但 开始 前 ， 先 介绍 Selenium 和 Selenide。 


7.4.3 Selenium 和 Selenide 


Selenium 是 一 组 用 于 自动 化 浏览 器 的 驱动 程序 ， 我 们 可 使 用 它们 操作 浏览 器 和 页 面 元 素 ， 如 
单 击 按钮 或 链接 、 填 写 表 单字 段 、 打 开 特 定 的 URL 等 。 几 乎 有 用 于 任何 浏览 器 的 驱动 程序 : 
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Android 、Chrome 、FireFox 、Internet Explorer 、Safari 等 等 。 我 们 喜欢 的 是 PhantomJS ， 这 是 一 款 
无 界面 浏览 器 (headless browser )， 不 使 用 任何 UI 就 能 工作 。 使 用 它 运 行 故 事 比 使 用 传统 浏览 
要 快 ， 我 们 常用 其 快速 获取 有 关 Web 应 用 程序 就 绪 程 度 的 反馈 。 如 果 Web 应 用 程序 像 预 期 那样 工 
作 ， 就 可 接着 尝试 在 要 支持 的 所 有 浏览 器 和 版 本 中 运行 。 


有 关 Selenium 的 更 详细 信息 ,请 参阅 http://www.seleniumhq.org/; 有 关 它 支持 的 驱动 程序 清单 ， 
请 参阅 http://www.seleniumhq.org/projects/webdriver/。 


虽然 Selenium 非 常 适合 用 于 自动 化 浏览 器 , 但 它 也 有 缺点 , 其 中 之 一 就 是 在 很 低 的 层面 操作 。 
例如 ， 单 击 按钮 很 容易 ， 只 需 使 用 一 行 代码 就 能 实现 : 


selenium.click ("myLink") 


如 果 ID 为 myLink 的 元 素 不 存在 ，Selenium 将 引发 异常 ， 测 试 将 失败 。 虽 然 我 们 希望 测试 在 
“期 望 的 元 素 不 存在 ”时 失败 ， 但 很 多 情况 下 ， 人 情况 并 非 这 样 简单 。 例 如 ， 页 面 可 能 是 动态 加 载 
的 ,期 望 的 元 素 仅 在 向 服务 器 发 出 的 异步 请 求 得 到 响应 后 才 出 现 。 有 鉴于 此 , 我 们 可 能 希望 等 到 
这 个 元 素 出 现 后 再 单 击 一 一 仅 当 等 待 超 时 时 ， 测 试 才 失 败 。 虽 然 使 用 Selenium 能 够 实现 这 样 的 目 
标 ， 但 既 繁 琐 又 容易 出 错 。 另 外 ， 对 于 Selenide 已 经 做 了 的 工作 ， 我 们 为 何 还 要 去 做 呢 ? 下 面 介 


绍 Selenide。 
































Selenide ( http://selenide.org/ ) 是 一 个 Selenium WebDriver 包 装 器 ,其 API 更 简洁 , 还 支持 Ajax、 
jQuery 式 选 择 器 等 。 对 于 所 有 Web 步 又， 我 们 都 将 使 用 Selenide， 稍 后 你 将 更 深入 地 了 解 它 。 


下 面 编写 一 些 代码 。 

















7.4.4 JBehave 步骤 


着 手 编写 步骤 前 ， 先 安装 PhantomJS 训 览 器 。 有 关 如 何在 你 使 用 的 操作 系统 中 安装 这 个 训 览 
器 的 说 明 ， 请 参阅 http:/phantomjs.org/download.html。 























安装 PhantomJS 后 ， 指 定 几 个 Gradle 依 赖 : 


dependencies { 
testCompile 'junit:junit:4.+' 
testCompile 'org.jbehave:jbehave-core:3.+' 
testCompile 'com.codeborne:selenide:2.+' 
testCompile 'com.codeborne:phantomjsdriver:1.+' 


} 


你 对 JUnit 和 jbehave-core 很 熟悉 ， 这 两 个 依赖 都 在 前 面 指定 过 ; 这 里 新 增 的 两 个 依赖 是 
Selenide 和 PhantomJS 。 请 刷新 Gradle 依 赖 ， 将 它们 包含 到 你 的 IDEA 项 目 。 


将 PhantomJS WebDriver 添 加 到 steps 类 
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public class Steps { 


private WebDriver webDriver; 


@BeforeStory 
public void beforeStory() { 
if (webDriver == null) { 


webDriver = new PhantomJSDriver(); 

WebDriverRunner.setWebDriver (webDriver); 

webDriver.manage() .window() .setSizel( 
new Dimension(1024, 768) 


> 


} 


我 们 使 用 注解 eBeforestory 指 定 了 进行 基本 设置 的 方法 。 如 果 没 有 指定 驱动 程序 ,我 们 就 
将 其 设置 为 PhantomJSDriver。 由 于 这 个 应 用 程序 在 小 型 设备 (手机 、 平 板 电 脑 等 ) 上 的 外 观 
不 同 ， 因 此 必须 明确 指定 屏幕 大 小 ， 这 很 重要 。 这 里 ， 我 们 将 其 设置 为 台式 机 /笔记 本 电脑 显示 
器 的 适中 屏幕 分 辨 率 一 1024 x 768。 



































完成 设置 后 ， 编 写 第 一 个 待定 步 又 的 代码 。 为 此 ,可 以 直接 复制 Behave 在 报告 中 推荐 的 第 
一 个 方法 : 


@Given("user is on the books screen") 

public void givenUserIisOnTheBooksScreen() { 
// PENDING 

} 





想象 我 们 的 应 用 程序 包含 一 个 打开 图 书页 面 的 链接 。 为 打开 这 个 页 面 ， 需 要 执行 两 个 步 又 : 
(1) 打开 网 站 主页 ; 
(2) 单 击 菜单 中 的 books 链 接 。 


我 们 将 这 个 链接 的 ID 指定 为 bpooks。ID 非 常 重要 ， 使 我 们 能 够 轻松 找到 页 面 中 的 元 素 。 
可 将 前 述 步 又 转换 为 如 下 代码 : 
private String url = "http://localhost:9001"; 


@Given("user is on the books screen") 
public void givenUserIisOnTheBooksScreen() { 
open (ur1l); 
$("#books") .click(); 
} 


这 里 假设 我 们 的 程序 将 运行 于 本 地 主机 (localhost ) 的 9001 端 口 ， 因 此 首先 打开 主页 URL， 
再 单 击 ID 为 books 的 元 素 (指定 ID 的 selenidqe/jouery 语 法 为 # )。 
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如 果 再 次 运行 前 面 定义 的 运行 器 ， 将 看 到 第 一 个 步 又 失败 ， 而 其 他 步 又 依然 处 于 待定 状态 。 
此 时 ， 我 们 处 于 “ 红 灯 - 绿 灯 - 重 构 ” 周 期 的 红 灯 阶 段 。 
接着 处 理 第 一 个 场景 使 用 的 其 他 步骤 。 第 二 个 步骤 的 代码 可 能 如 下 所 示 : 
@Then ("field bookId exists") 


public void thenFieldBookIdExists() { 
Ss("#books") .shouldBe (visible); 





} 
第 三 个 步 又 几乎 与 此 相同 ， 因 此 可 以 重 构 前 一 个 方法 ， 将 元 素 ID 转 换 为 变量 : 


@Then ("field S$SelementId exists") 
public void thenFieldExists(String elementId) { 
S$S("#" + elementId) .shouldBe (visible); 





} 
经 过 这 样 的 修改 后 , 第 一 个 场景 中 的 步骤 就 都 完成 了 。 如 果 再 次 运行 测试 , 结果 将 如 下 所 示 。 





Scenario: Book details form should have all fields 


Given user is on the books screen (FAILED) 

Element not found {#books} Expected: visible Screenshot: 
file:/home/vfarcic/IdeaProjects/tdd-java-ch07-books- 
store/build/reports/tests/1430688921325.15.png Timeout: 4 s. Caused by: 
NoSuchElementException: Error Message => "Unable to find element with css selector 
#books” 


Then field bookld exists (NOT PERFORMED) 

Then field bookTitle exists (NOT PERFORMED) 

Then field bookAuthor exists (NOT PERFORMED) 
Then field bookDescription exists (NOT PERFORMED) 


第 一 个 步 又 失败 了 ， 因 为 我 们 还 未 开始 编写 书店 应 用 程序 的 实现 。Selenide 有 一 项 很 不 错 的 
功能 : 每 当 失 败 时 都 创建 浏览 器 的 屏幕 截图 ， 并 在 报告 中 指出 其 存储 路 径 。 其 他 步 又 都 处 于 未 执 
行 (not performed ) 状态 ， 因 为 失败 后 场景 便 会 停止 执行 。 


接 下 来 该 做 什么 呢 ? 这 取决 于 团队 的 结构 。 如 果 功 能 测试 和 实现 由 同一 人 负责 , 这 个 人 就 可 
开始 处 理 实现 一 一 编写 刚好 让 这 个 场景 能 够 通过 的 代码 。 功 能 测试 和 实现 代码 通常 由 不 同 的 人 负 
责 , 这 种 情况 下 ,负责 功能 测试 的 人 可 接着 编写 其 他 场景 中 缺失 的 步骤 ， 而 负责 实现 代码 的 人 可 
着 手 处 理 实现 。 由 于 所 有 场景 都 以 文本 方式 编写 , 程序 员 知 道 该 做 什么 因此 他 和 负责 功能 测试 
的 人 可 并 行 工 作 。 这 里 假设 属于 后 一 种 情况 ， 因 此 接着 为 其 他 待定 步骤 编写 代码 。 


下 面 运行 第 二 个 场景 。 
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Scenario: User should be able to create a new book 


Given user is on the books screen (FAILED) 

Element not found {#books} Expected: visible Screenshot: 
file:/home/vfarcic/IdeaProjects/tdd-java-ch07-books- 
store/build/reports/tests/1430690653894.32.png Timeout: 4 s. Caused by: 
NoSuchElementException: Error Message => 'Unable to find element with css selector 
#books" 


When user clicks the button newBook (NOT PERFORMED) 
When user sets values to the book form (PENDING) 

When user clicks the button saveBook (NOT PERFORMED) 
Then book is stored (PENDING) 


这 个 场景 中 ， 一 半 的 步骤 已 在 前 一 个 场景 完成 ， 只 有 两 个 步骤 待定 。 单 击 按钮 newBook 后 ， 
我 们 应 该 在 表单 中 填写 一 些 值 , 再 单 击 按钮 saveBook, 并 验证 图 书 被 正确 保存 。 对 于 最 后 一 部 分 ， 
可 通过 检查 图 书 是 否 出 现在 可 售 图 书 列表 完成 。 
缺失 的 步骤 可 能 如 下 所 示 : 
@When("user sets values to the book form") 


public void whenUserSetsValuesToTheBookForm() { 
$("#bookId") .setValue ("123"); 














$s("#bookTitle") .setValue ("BDD Assistant"); 
$("#bookAuthor") .setValue ("Viktor Farcic"); 
$("#bookDescription") .setValuel( 


"Open source BDD stories editor and runner" 
}s 
} 
@Then("book is stored") 
public void thenBookIsStored() { 
S("#book123") .shouldBe (present);} 


第 二 个 步骤 假定 每 本 可 售 图 书 都 有 一 个 格式 为 pook [ID] 的 ID。 
来 看 下 一 个 场景 。 





Scenario: User should be able to display book details 


Given user is on the books screen (FAILED) 

Element not found {#books} Expected: visible Screenshot 
file:/home/vfarcic/IdeaProjects/tdd-java-ch07-books- 
store/build/reports/tests/1430691141869.46.png Timeout: 4 s. Caused by: 
NoSuchElementException: Error Message => 'Unable to find element with css selector 
#books" 


When user selects a book (PENDING) 
Then book form contains all data (PENDING) 


与 前 一 个 场景 一 样 ， 有 两 个 待定 步 又 需要 开发 。 我 们 需要 一 种 选择 图 书 的 方式 ， 还 需 验 证 表 
单 中 的 数据 是 否 正确 : 
@When ("user selects a book") 


public void whenUserSelectsABook() { 
S("#book1") .click(); 
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@Then ("book form contains all data") 
public void thenBookFormContainsAllData() { 
$("#bookId") .shouldHave (value ("1")); 
S$("#bookTitle").shouldHavel( 
value ("TDD for Java Developers") 


人 
$("#bookAuthor") .shouldHave (value ("Viktor Farcic")); 
S$S("#bookDescription").shouldHave(value ("Cool book!")); 


} 


这 两 个 方法 很 有 趣 ， 因 为 它们 不 仅 指 定 了 期 望 的 行为 ( 特定 图 书 链接 被 单 击 时 , 将 显示 一 个 
包含 其 数据 的 表单 )， 还 期 望 有 一 些 可 用 于 测试 的 数据 。 这 个 场景 运行 时 ， 应 存在 这 样 的 图 书 : 
ID 为 1、 书 名 为 TDD for Java Developers、 作 者 为 viktor Farcic、 描 述 为 Cool1 book!。 
我 们 可 将 这 些 数据 添加 到 数据 库 ， 也 可 使 用 模拟 服务 器 提供 这 些 预 定义 的 值 。 无 论 我 们 如 何 设置 

这 些 测试 数据 ， 都 可 完成 这 个 场景 并 进入 下 一 个 。 





Scenario: User should be able to update book details 


Given user is on the books screen (FAILED) 

Element not found {#books} Expected: visible Screenshot- 
file:/home/vfarcic/IdeaProjects/tdd-java-ch07-books- 
store/build/reports/tests/1430692088078.61.png Timeout: 4 s. Caused by: 
NoSuchElementException: Error Message => 'Unable to find element with css selector 
#books" 

When user selects a book (NOT PERFORMED) 

When user sets new values to the book form (PENDING) 


Then book is updated (PENDING) 


这 些 待定 步骤 的 实现 可 能 如 下 所 示 : 











@Whenl("user sets new Values to the book form") 

public void whenUserSetsNewValuesToTheBookForm() { 
$("#bookTitle") .setValuel( 

"TDD for Java Developers revised" 





$("#bookAuthor") .SetValue 人 
"Viktor Farcic and Alex Garcia" 








); 
$("#bookDescription") .setValue("Even better book!"); 
Ss("#saveBook") .click(); 


@Then("book is updated") 
public void thenBookIsUpdated() { 
S$ ("#book1") .shouldHavel( 
text ("TDD for Java Developers revised") 


3 

S("#lbook1") .click(); 
$("#bookTitle").shouldHavel( 

value ("TDD for Java Developers revised") 











S$ ("#bookAuthor") .shouldHave 
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value ("Viktor Farcic and Alex Garcia") 
这 
$("#bookDescription").shouldHavel 
value ("Even better book!") 
); 
} 


至 此 ， 只 余下 一 个 场景 。 





Scenario: User should be able to delete a book 


Given user is on the books screen (FAILED) 

Element not found {#books} Expected: visible Screenshot 
fle:homevfarcic/ldeaProjects/tdd-java-ch07-books- 
store/build/reports/tests/1430692818420.77.png Timeout: 4 s. Caused by: 
NoSuchElementException: Error Message => "Unable to find element with css selector 
#books" 

When user selects a book (NOT PERFORMED) 

When user clicks the button deleteBook (NOT PERFORMED) 

Then book is removed (PENDING) 


可 通过 确认 图 书 不 包含 于 可 售 图 书 列表 验证 它 已 被 删除 : 











@Then("book is removed") 

public void thenBookIsRemoved() { 
S$("#book1") .shouldNotBe (visible); 

} 


至 此 ,步骤 的 代码 全 部 编写 完成 。 现 在 , 开发 应 用 程序 的 人 不 仅 有 需求 ,还 有 验证 每 个 行为 
(场景 ) 的 途径 ， 可 使 用 “ 红 灯 - 绿 灯 - 重 构 ” 周 期 每 次 实现 一 个 场景 。 

















可 在 Git 仓 库 tdad-java-ch07-books-store 的 分 支 02-steps (https://bitbucket.org/vfarcic/ 
tdd-java-ch07-books-store/branch/02-steps ) 中 找到 源 代码 。 


7.4.5 最 后 的 验证 


假设 有 男 一 人 负责 编写 代码 以 实现 场景 指定 的 需求 , 它 每 次 挑选 一 个 场景 , 开发 代码 并 运行 
场景 以 确认 其 实现 是 正确 的 。 所 有 场景 都 实现 后 ， 运 行 整个 故事 进行 最 后 的 验证 。 


我 们 将 这 个 应 用 程序 打包 为 一 个 Docker 文 件 ， 并 创建 运行 该 应 用 程序 的 Vagrant 虚 拟 机 。 


























请 签 出 分 支 https://bitbucket.org/vfarcic/tdd-java-ch07-books-store/branch/03-validation 并 运行 


Vagrant: 
$ vagrant up 
输出 应 如 下 所 示 : 
==> default: Importing base box 'ubuntu/trusty64'... 


==> default: Matching MAC address for NAT networking... 
==> default: Checking if box 'ubuntu/trusty64' is up to date... 
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==> default: Running provisioner: docker... 
default: Installing Docker (latest) onto machine... 
default: Configuring Docker to autostart containers... 
==> default: Starting Docker containers... 
==> default: -- Container: books-fe 


Vagrant 虚 拟 机 安装 完毕 后 ， 可 在 浏览 需 中 输入 http:/localhost:9001 运 行 这 个 应 用 程序 : 
My Application Books 


Books 


TDD for Java Developers 


How to delete something 
Title 3 TDD for Java Developers 


Author 


Viktor Farcic 


Description 


Cool book! 





Delete 





现在 再 次 运行 我 们 的 场景 : 
$ gradle clean test 


这 次 没有 失败 ， 所 有 场景 都 成 功 运行 。 





Narrative: 


In order to manage the book store collection 
As a store administrator 
1want to be able to perform insert, update and delete operations 





Scenario: Book details form should have all fields 


Given User is on the books screen 
Then field bookld exists 

Then field bookTitle exists 

Then field bookAuthor exists 
Then field bookDescription exists 


Scenario: User should be able to create a new book 


Given user is on the books screen 
When user clicks the button newBook 
When user sets values to the book form 
When user clicks the button saveBook 
Then book is stored 























所 有 场景 都 通过 后 ， 满 足 验 收 标准 ， 可 将 应 用 程序 部 署 到 生产 环境 。 
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7.5 小结 

从 本 质 上 说 ，BDD 是 一 个 TDD 变 种 ， 遵 循 同样 的 基本 原则 : 先 编 瑟 测试 (场景 )， 再 编写 实 
现代 码 。 它 驱动 开发 ， 并 帮助 我 们 更 好 地 理解 该 做 什么 。 

主要 差别 之 一 是 周期 的 持续 时 间 。 基 于 单元 测试 的 TDD 中 ，, 我 们 快速 从 红 灯 切 换 到 绿灯 (在 
几 分 钟 乃 至 几 秒 钟 内 ); 而 BDD 通 常 采用 更 高 级 的 方法 ， 从 红 灯 切 换 到 绿灯 可 能 需要 几 小 时 乃至 
几 天 。 另 一 个 重要 差别 是 受众 。 基 于 单元 测试 的 TDD 是 开发 人 员 为 开发 人 员 做 的 ; 而 BDD 使 用 的 
是 普通 语言 ， 通 常 涉及 所 有 团队 成 员 。 

有 关 这 个 主题 可 以 写 部 专著 ， 而 我 们 的 目的 是 向 你 提供 足够 信息 ， 让 你 能 够 更 深入 地 研究 
BDD, 


现在 看 看 遗留 代码 ， 以 及 如 何 对 遗留 代码 进行 修改 ,使 其 对 测试 驱动 开发 更 友好 。 
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第 8 章 
重 构 遗留 代码 一 一 
使 其 重 焕 青 春 








“恐惧 是 通 向 黑暗 之 路 。 恐 惧 导 致 愤怒 ; 愤怒 引发 仇恨 ; 仇恨 造成 痛苦 。” 





尤 达 
TDD 不 能 直接 应 用 于 遗留 代码 ， 可 能 需要 稍微 调整 步 又 才 管用 。 用 于 处 理 遗 留 代码 时 ，TDD 可 能 
需要 调整 ， 即 你 执行 的 不 再 是 你 习惯 的 TDD。 本 章 带 你 进入 遗留 代码 领域 ， 并 尽 可 能 吸收 TDD 的 养分 。 


我 们 将 改 弦 易 轩 ， 处 理 一 个 正 用 于 生产 的 遗留 应 用 程序 。 我 们 将 小 步 修改 这 个 应 用 程序 ， 以 
免 导致 缺陷 或 退化 ， 这 样 就 能 早早 吃 上 午餐 ! 


本 章 涵 盖 如 下 主题 : 


口 遗留 代码 ; 

口 处 理 遗 留 代 码 ; 

口 REST 通 信 ; 

口 依赖 注入 ; 

口 不 同 层级 的 测试 : 端 到 端 测试 、 集 成 测试 和 单元 测试 。 


8.1 遗留 代码 8 


先 定 义 “ 遗 留 代码 ”。 很 多 作者 都 给 “遗留 代码 ”下 了 不 同 定 义 ， 如 受信 任 的 应 用 程序 或 测 
试 、 不 再 支持 的 代码 等 ， 但 我 们 最 喜欢 Michael Feathers 的 定义 : 



































“遗留 代码 就 是 不 带 测试 的 代码 。 
为 什么 这 样 定义 呢 ? 因为 它 是 客观 的 : 要 么 带 测试 ， 要 么 不 带 测试 .” 


Michael Feathers 
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如 何 识 别 遗 留 代 码 呢 ?” 虽 然 遗 留 代 码 通常 都 充斥 着 粳 糕 的 代码 , 但 Michael Feathers 在 其 著作 




















《修改 代码 的 艺术 》 中 指出 了 遗留 代码 的 一 些 坏 味 。 


AI 


代码 坏 味 
坏 味 是 代码 中 违背 了 基本 设计 元 素 并 给 设计 质量 带 来 负面 影响 的 结构 .代码 
坏 味 通常 不 同 于 bug， 它 们 从 技术 上 说 是 正确 的 ， 不 会 导致 程序 无 法 正常 运行 。 
而 是 昭示 着 设计 存在 缺陷 ， 这 些 缺 陷 可 能 影响 开发 速度 或 增加 未 来 出 现 bug 或 故 
障 的 风险 。 
一 一 摘自 http://en.wikipedia.org/wiki/Code_smell 





遗留 代码 存在 的 一 种 常见 坏 味 是 无 法 测试 。 它 们 访问 外 部 资源 、 带 来 其 他 副作用 、 使 用 new 








运算 符 等 。 一 般 而 言 ， 良 好 的 设计 都 易于 测试 。 下 面 看 一 些 遗 留 代码 。 
遗留 代码 示例 


要 对 软件 概念 进行 诠释 ， 通 常 最 容易 的 方式 是 通过 代码 ， 这 个 概念 也 不 例外 。 第 3 章 介绍 并 




















编写 了 “ 井 字 游戏 ”， 其 中 的 如 下 代码 检查 落 子 位置 是 否 有 效 : 








public class TicTacToe { 


public void validatePosition(int x, int y) { 


} 


TT 
throw new RuntimeException("X is outside " 
"Doard TT)y 
} 
TF (We ol 
throw new RuntimeException("Y is outside " 
+ "board"); 


与 这 些 代 码 对 应 的 规范 如 下 所 示 : 


public class TicTacToeSpec { 


@Rule 
public ExpectedException exception = 


ExpectedException.none(); 


private TicTacToe ticTacToe; 


@Before 
public final void before() { 


} 


ticTacToe = new TicTacToe(); 
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@Test 


public void whenxXOutsideBoardThenRuntimeException\() 


exception.expect (RuntimeException.class); 
ticTacToe.validatePosition(5, 2); 


@Test 
public void whenYOutsideBoardThenRuntimeException\() 


{ 


exception.expect (RuntimeException.class); 
ticTacToe.validatePosition(2, 5); 


} 








JaCoCo 报 告 指出 ， 测 试 覆 盖 了 除 最 后 一 行 ( 结束 方法 的 大 插 号 ) 外 的 所 有 代码 。 





@ TicTacToe x | (®@ TicTacToeSpec x 








1 :package com.packtpublishing.tddjava.ch@3tictactoe; 





‘public class TicTacToe { 


晶 public void validatePosition(int x, int y) { 
i if (x<1||x>3)t 
i throw new RuntimeException("X is outside board"); 


[ if (y<1||ly>3)1 


throw new RuntimeException("Y is outside board"); 














| } 

a 了】 

} 
@006 Coverage | 
Coverage TicTacToeSpec + | 
全 Coverage Summary for Package 'com.packtpublishing. EE ch0.. 

Element Class,% Method, % Line, % 

党 100% (1/1) 100% (212) EI 
出 
T 
Ea 











确信 测试 很 好 地 覆盖 了 代码 后 ， 就 可 凭 感觉 进行 安全 的 重 构 了 (片段 ): 


public class TicTacToe { 


public void validatePosition(int x, int y) { 
if (isOutsideTheBoard(x)) { 
throw new RuntimeException("X is outside " 
+ "board"); 
} 
if (isOutsideTheBoard(y)) { 


throw new RuntimeException("Y is outside " 
+ "board"); 


private boolean isOutsideTheBoard 
(final int position) { 
return position < 1 || position > 3; 


图 灵 社 区 会 员 yasenluobinh(yasenluobinhappy@163.com) 专 享 尊重 版 权 





150 ”第 8 章 重 构 遗 留 代码 一 使 其 重 焕 青春 





这 些 代码 应 该 疫 问题 ， 因 为 测试 成 功 ， 且 测试 的 代码 覆盖 率 很 高 。 
你 可 能 也 这 样 认 为 , 但 有 一 点 需要 注意 : 对 于 RuntimeException 块 中 的 消息 , 我 们 并 未 检 














查 其 正确 性 ， 虽 然 代 码 覆 盖 率 报告 指出 “覆盖 了 所 有 分 支 "。 
代码 覆盖 率 到 底 是 什么 ? 
代码 覆盖 率 是 一 个 指标 ,用 于 描述 特定 测试 套件 在 多 大 程度 上 对 程序 源 代码 
做 了 ey ee a | a 


一 一 摘自 http://en.wikipedia.org/wiki/Code coverage 


假设 有 一 个 端 到 端 测 试 , 覆盖 了 一 部 分 简单 代码 ， 其 代码 覆盖 率 将 很 高 , 但 并 不 能 让 你 高 枕 
无 优 ， 因 为 很 多 其 他 部 分 未 覆盖 

前 面 在 代码 库 中 引入 了 遗留 代码 一 一 异常 消息 ,这样 做 也 许 没 错 , 只 要 它 不 是 被 依赖 的 行为 ， 
即 没有 依赖 该 异常 消息 : 调试 程序 的 程序 员 不 依赖 它 ， 日 志 不 依赖 它 ， 最 终 用 户 也 不 依赖 它 。 不 
入 的 将 来 ， 程 序 中 未 被 测试 覆盖 的 部 分 可 能 退化 ， 只 要 你 能 接受 这 样 的 风险 即 可 。 

也 许 ， 只 要 知道 哪个 代码 行 出 现 了 什么 样 的 异常 就 够 了 。 有 鉴于 此 ， 我们 决定 删除 这 条 未 被 
测试 的 异常 消息 : 


















































public class TicTacToe { 


public void validatePosition(int x, int y) { 
if (isOutsideTheBoard(x)) { 
throw new RuntimeException(""); 
} 
if (isOutsideTheBoard(y)) { 
throw new RuntimeException(""); 


} 
private boolean isOutsideTheBoard 


(final Lnt BOSIt1ion).{ 
return position < 1 || position > 3; 


1. 识别 遗留 代码 的 其 他 方式 

你 可 能 熟悉 下 面 一 些 昭 示 着 遗留 应 用 程序 的 迹象 : 
口 补丁 层 补 丁 ， 癸 然 是 作法 自 丝 的 科学 怪人 ; 

口 已 知 的 bug; 


口 修改 代价 高 昂 ; 
口 脆弱 ; 
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口 难以 理解 ; 

口 文档 老 旧 、 过 期 、 一 成 不 变 ， 甚 至 根本 没有 文档 ; 
口 零 弹 式 修改 ; 

口 破 窗 效应 。 


这 给 应 用 程序 维护 团队 带 来 如 下 影响 : 


口 放弃 : 摆 在 软件 负责 者 面前 的 是 巨大 的 任务 ; 
口 没 人 关心 : 系统 一 旦 出 现 受 损 的 窗户 ， 就 更 容易 出 现 其 他 受 损 窗 户 。 


遗留 代码 处 理 起 来 通常 比 其 他 软件 更 琼 手 ， 因 此 你 可 能 想 让 最 优秀 的 员工 负责 处 理 。 然 而 ， 
我 们 常常 被 最 后 期 限 弄 得 手忙脚乱 , 只 想 尽 快 将 必 不 可 少 的 功能 开发 出 来 ,而 对 解决 方案 的 质量 
不 闻 不 问 。 


因此 ， 为 避免 以 如 此 糟糕 的 方式 浪费 优秀 人 才 , 我 们 希望 非 遗 留 应 用 程序 完全 相反 ,， 即 具备 
如 下 特点 : 


口 易于 修改 ; 

口 可 推广 、 可 配置 、 可 扩展 ; 
口 易于 部 署 ; 

口 健壮 ; 
口 没有 已 知 的 缺陷 或 局 限 ; 

口 很 容易 讲解 ， 也 很 容易 了 解 ; 
口 大 量 测试 套件 ; 

口 自动 验证 ; 

口 可 采取 “ 微 创 手术 ”进行 修改 。 


前 面 列 出 了 遗留 代码 和 非 遗 留 代码 的 一 些 特征 , 好 像 很 容易 将 某 些 特征 变 成 其 他 特征 , 不 是 
吗 ? 停止 截 弹 式 修改 ， 转 而 采取 “ 微 创 手术 "， 再 添加 一 些 细节 ， 就 大 功 告 成 了 。 果 真如 此 吗 ? 


可 没有 那么 容易 。 好 在 有 一 些 技巧 和 规则 , 我 们 可 使 用 它们 改善 代码 ,让 应 用 程序 更 类 似 于 
非 遗 留 的 。 


2. 依赖 不 是 注入 的 


这 是 遗留 代码 库 最 常见 的 一 种 坏 味 : 对 于 不 需要 在 隔离 情况 下 进行 测试 的 类 , 在 需要 时 直接 
实例 化 协作 者 ， 导 致使 用 协作 者 的 类 同时 负责 创建 。 


比如 使 用 new 运 算 符 : 


public class BirthdayGreetingService { 



































































































































private final MessageSender messageSender; 
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public BirthdayGreetingService() { 
messageSender = new EmailMessageSender(); 


} 


public void greet (final Employee employee) { 
messageSender.send(employee.getAddress(),， 
"Greetings on your birthday"); 
3. 
} 
你 无 法 对 这 个 BirthdqayGreeting 服 务 进行 单元 测试 。 它 依赖 的 Email1Mes sageSender 是 
在 构造 函数 中 创建 的 , 如 果 不 修改 代码 库 , 就 无 法 替换 这 个 依赖 ( 除非 使 用 反射 注入 对 象 或 在 new 
运算 符 中 替换 对 象 )。 


修改 代码 库 是 导致 退化 的 温床 , 一 定 要 三 思 而 后 行 。 要 重 构 ， 就 需要 有 测试 ( 除非 根本 没 法 
编写 测试 )。 











总 遗留 代码 困境 
修改 代码 前 ， 必 须 准备 好 测试 ; 而 要 准备 好 测试 ， 通 常 要 修改 代码 。 


3. 遗留 代码 修改 算法 
必须 对 遗留 代码 进行 修改 时 ， 可 使 用 如 下 算法 : 


口 确定 修改 点 ; 
口 找 出 测试 点 ; 
口 消除 依赖 ; 
口 编写 测试 ; 
口 修改 并 重 构 。 








4. 应 用 遗留 代码 修改 算法 


为 应 用 这 种 算法 , 通常 先 编写 一 组 测试 , 并 在 重 构 期 间 确保 这 些 测试 始终 能 通过 。 这 不 同 于 
正常 的 TDD 周 期 ， 因 为 重 构 不 能 引入 任何 新 功能 ， 即 不 应 编写 任何 新 规范 。 


为 更 好 地 解释 这 种 算法 ,假设 我 们 被 要 求 做 如 下 修改 : 
为 更 轻松 问候 员工 ,我 想 给 他 们 发 推 特 消息 而 不 是 电子 邮件 。 


(1) 确定 修改 点 


















































当前 , 这 个 系统 只 能 发 送 电子 邮件 , 因此 必须 修改 。 在 哪里 修改 呢 ? 经 过 简单 的 调查 可 发 现 ， 
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问候 方式 是 在 BirthdayGreetingService 类 的 构造 函数 中 决定 的 ,这 个 构造 函数 采用 了 策略 模 
式 (https://en.wikipedia.org/?title=Strategy_pattern )， 如 下 述 代码 片段 所 示 : 





public class BirthdayGreetingService { 


public BirthdayGreetingService() { 
messageSender = new EmailMessageSender (); 
} 
I | 
} 


CO) 找 出 测试 点 


BirthdayGreetingService 类 没有 任何 注入 的 协作 者 可 为 其 添加 额外 的 功能 , 因此 只 能 在 
这 个 服务 类 外 部 对 其 进行 测试。 一 种 办 法 是 修改 EmailMessageSsender 类 ， 将 其 实现 蔡 换 为 模 
所 或 伪造 实现 ,但 这 是 拿 这 个 类 的 实现 冒险 。 


另 一 种 选择 是 为 这 项 功能 编写 一 个 端 到 端 测 试 : 


public class EndToEndTest { 



































@Test 
public void email_an employee() { 
final StringBuilder systemOutput = 
injectSystemOutput (); 
final Employee john = new Employeel 
new Email ("john@example.com")); 


new BirthdayGreetingService() .greet (john); 


assertThat (systemOutput .上 toString() ， 
edqualTo ("Sent email to " 
+ "'john@example.com' with " 
+ "the body 'Greetings on your " 
+ "birthday'\n")); 
} 


// 这 些 代码 来 自 GCMaur's LegacyUtils (https://github.com/GMaur/legacyutils) 
// 获 得 了 它们 的 许可 : 
private StringBuilder injectSystemOutput() { 
final StringBuilder stringBuilder = 
new StringBuilder(); 
final PrintStream outputPrintStream = 
new PrintStrearm( 
new OutputStream() { 
QOverride 
public void write(final int b) 
throws IOException { 
stringBuilder.append( (char) b); 
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System.setOut (outputPrintStream); 
return stringBuilder; 
了 
} 


我 们 在 获得 许可 的 情况 下 从 https://github.com/GMaur/legacyutils 借 鉴 了 这 些 代码 ,这 个 库 旨 在 
帮助 你 捕捉 系统 输出 ( system.out )。 


这 个 文件 的 文件 名 不 像 TicTacToeSpec 等 那样 以 Spec 结 尾 。 这 个 测试 由 在 确保 相应 功能 保持 不 
变 ， 其 所 属 文件 名 为 EndToEndTest ， 因 为 我 们 力图 覆盖 尽 可 能 多 的 功能 。 


(3) 消除 依赖 


创建 旨 在 确保 预期 行为 不 变 的 测试 后 ， 下 面 解除 BirthdayGreetingSservice 和 Email 
MessageSender 之 间 的 硬 编码 式 依赖 。 为 此 ， 我 们 将 使 用 一 种 名 为 “提出 并 重 写 调 用 ”的 技术 ， 
这 种 技术 是 Michaels Feathers 在 其 著作 中 首次 提出 的 : 


public class BirthdayGreetingService { 


















































public BirthdayGreetingService() { 
messageSender = getMessageSender () 


} 
private MessageSender getMessageSender() { 
return new EmailMessageSender () ; 
} 
[sa] 
再 次 运行 测试 , 我 们 编写 的 唯一 一 个 测试 通过 了 。 为 让 这 个 方法 可 重 写 , 需要 将 其 改 为 受 保 
护 或 公有 的 : 


public class BirthdayGreetingService { 














protected MessageSender getMessageSender() { 
return new EmailMessageSender (); 


} 
eae 
在 测试 文件 夹 中 创建 一 个 伪造 对 象 。 使 用 代码 引入 伪造 对 象 是 一 种 模式 : 创建 一 个 对 象 , 它 
可 用 于 替代 既 有 对 象 , 且 其 行为 是 可 控 的 。 这样 就 能 通过 注入 一 些 自 定义 的 伪造 对 象 满足 我 们 的 
需求 。 有 关 这 个 模式 的 更 详细 信息 ， 请 参阅 http://xunitpatterns.com/。 
在 这 里 ,我 们 应 创建 一 个 伪造 的 服务 , 它 扩 展 原来 的 服务 。 下 一 步 是 重 写 复 森 的 方法 ,以 绕 
开 与 测试 无 关 的 代码 : 






































public class FakeBirthdayGreetingService 
extends BirthdayGreetingService { 
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@Override 
protected MessageSender getMessageSender() { 
return new EmailMessageSender () ; 


} 
现在 ,我 们 可 以 使 用 这 个 伪造 对 象 ， 而 不 使 用 BirthdayGreetingService 类 : 


public class EndToEndTest { 





@Test 
public void email_an employee() { 
final StringBuilder systemOutput = 
injectSystemOutput (); 
final Employee john = new Employeel 
new Email ("john@example.com")); 


new FakeBirthdayGreetingService() .greet (john); 


assertThat (systemOutput.tostring(), 
equalTo("Sent email to " 
+ "'john@example.com' with " 
+ "the body 'Greetings on " 
+ "your birthday'\n")); 
} 


这 个 测试 也 通过 了 。 














现在 ， 可 使 用 Feathers 在 其 论文 (http://www.objectmentor.com/resources/articles/WorkingEffec- 
tivelyWithLegacyCode.pdf ) 中 阐述 的 男 一 个 依赖 解除 技巧 一 一 参数 化 构造 函数 。 产 品 代码 可 能 如 
下 所 示 : 








public class BirthdayGreetingService { 
public BirthdayGreetingService(final MessageSender 
messageSender) { 
this.messageSender = messageSender; 
} 
上 述 实 现 对 应 的 测试 代码 如 下 所 示 : 


public class EndToEndTest { 





@Test 
public void email_an employee() { 
final StringBuilder systemOutput = 
injectSystemOutput (); 
final Employee john = new Employeel 
new Email("john@example.com")); 
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new BirthdayGreetingService (new 
EmailMessageSender()) .greet (john); 


assertThat (systemOutput.toString(), 
equalTo("Sent email to " 
+ "'john@example.com' with " 
+ "the body 'Greetings on " 
+ "your birthday'\n")); 
} 
[S03] 


现在 不 再 需要 FakeBirtnday， 可 以 将 其 删除 。 
(4) 编写 测试 


我 们 保留 前 面 的 端 到 端 测试 ， 同时 创建 一 个 交互 测试 验证 BirthdayGr tingServic 和 
MessageSender 之 则 的 集成 情况 : 


@Test 
public void the_ service_ should ask the messageSender() { 
final Email address = 
new Email ("john@example.com"); 
final Employee john = new Employee (address); 
final MessageSender messageSender = 
mock (MessageSender.class); 


























new BirthdayGreetingService (messageSender) 
.greet (john); 


verify (messageSender) .send (address, 
"Greetings on your birthday"); 


} 
现在 可 以 编写 新 的 TweetMessageSender 类 ， 完 成 遗留 代码 修改 算法 的 最 后 一 步 。 





8.2 编码 套路 
程序 员 要 提高 技能 ， 只 能 通过 练习 ， 别 无 他 法 。 使 用 不 同 技术 创建 不 同类 型 的 程序 , 通常 让 



























































程序 员 对 软件 开发 有 新 的 洞 见 。 编码 套路 是 一 种 秉承 这 种 理念 的 练习 , 定义 了 为 达成 某 种 目标 而 
必须 实现 的 需求 或 功能 。 





岗 
程序 员 被 要 求实 现 一 种 可 能 的 解决 方案 , 再 将 其 与 其 他 解决 方案 进行 比较 , 力图 找 出 最 佳 解 
决 方案 。 这 种 练习 的 重点 不 是 以 最 快速 度 实现 解决 方案 , 而 是 对 设计 解决 方案 期 间 做 出 的 决策 进 
行 讨论 。 大 多 数 情况 下 ， 在 编码 套路 中 创建 的 所 有 程序 最 终 都 会 被 丢弃 。 


本 章 的 编码 套路 针对 的 是 一 个 遗留 系统 。 这 个 程序 足够 简单 ,让 你 在 本 章 就 能 处 理 完毕 ; 同 
时 又 足够 复杂 ， 能 够 给 你 出 些 难题 。 
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8.2.1 遗留 代码 处 理 套路 


你 接受 了 一 项 任务 对 一 个 已 部 署 到 生产 环境 的 系统 进行 修改 。 这 个 系统 是 一 款 图 书馆 软 
件 一 一 名 为 Alexandria 的 项 目 。 


这 个 项 目 当前 没有 文档 ,原来 的 维护 人 员 也 联系 不 上 , 无 法 与 之 讨论 。 因 此 ， 如 果 你 接受 这 
项 任务 ， 就 得 完全 靠 自己 ， 因 为 没 人 可 以 指望 。 























8.2.2 ”描述 
我 们 想方设法 找到 了 最 初 编写 这 个 项 目 时 制定 的 如 下 规范 片段 : 


口 软件 Alexandria 必 须 能 够 存储 图 书 并 将 其 借 给 能 够 归还 的 有 用户。 用户 还 需 能 够 在 这 个 系统 
根据 作者 、 书 名 、 状 态 和 ID 搜 索 图 书 。 

口 对 于 归还 图 书 的 时 间 没 有 限制 。 

口 还 能 将 图 书 下 架 ， 因 为 出 于 商业 上 的 考虑 ， 这 很 重要 。 

口 这 个 软件 不 应 接纳 新 用 户 。 

口 应 随时 将 服务 时 间 告 知 用 户 。 




















8.2.3 ”技术 说 明 


Alexandria 是 一 个 使 用 Java 编 写 的 后 端 项 目 ， 使 用 REST API 向 前 端 提供 信息 。 为 简化 这 个 编 
人 码 套 路 ,使 用 测试 替身 ( 伪造 对 象 )、 以 内 存 对 象 的 方式 实现 持久 化 。 有 关 伪 造 对 象 的 更 详细 信 
息 ， 请 参阅 http://xunitpatterns.com/Fake%20Object.html。 














https://bitbucket.org/vfarcic/tdd-chapter-08/commits/branch/legacy-code 提 供 了 这 个 项 目的 现 有 代码 。 


8.2.4 添加 新 功能 


如 果 无 需 添加 新 功能 , 这 些 遗 留 代 码 可 能 不 会 给 程序 员 带 来 困扰 。 这 个 代码 库 的 状态 虽 不 理 
想 ， 但 生产 系统 运行 正常 ， 也 没有 带 来 什么 麻烦 。 


现在 问题 来 了 : 产品 所 有 者 (PO ) 要 添加 一 项 新 功能 。 
例如 , 给 定 一 本 图 书 , 图 书 管理 员 想 知道 其 完整 的 出 借 历史 , 以 便 确 定 哪些 图 书 更 受用 户 欢 迎 。 














8.2.5 ”墨盒 测试 还 是 尖峰 冲击 测试 


Alexandria 项 目 没有 文档 ， 也 无 法 向 以 前 的 维护 人 员 咨 询 ， 这 加 大 了 黑 盒 测 试 的 难度 。 有 鉴 
于 此 ， 我 们 决定 通过 调查 研究 更 深入 地 了 解 这 个 软件 ， 再 做 些 尖峰 冲击 获悉 系统 内 部 情况 。 
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后 面 将 根据 由 此 获得 的 信息 实现 新 功能 。 


黑 盒 测试 这 种 软件 测试 方法 在 不 探查 应 用 程序 内 部 结构 和 工作 原理 的 情况 
下 ， 对 其 功能 进行 检查 。 这 种 测试 方法 适用 于 各 个 层级 的 软件 测试 : 单元 测试 、 
集成 测试 、 系 统 测 试 和 验收 测试 。 较 高 层级 的 测试 大 多 乃至 全 部 都 是 黑 盒 测试 ， 
单元 测试 也 可 能 大 多 是 黑金 测试 = 
一 一 摘自 http:/en.wikipedia.org/wiki/Black-box _ testing 
有 关 黑 盒 测 试 的 更 详细 信息 ， 请 参阅 http:/agile.csc.ncsu.edu/SEMaterials/ 
BlackBox.pdf。 


8.2.6 初步 调查 
知道 需要 添加 的 新 功能 后 ， 开 始 调查 项 目 Alexandria: 


口 15 个 文件 ; 

口 基于 maven (pom.xml ); 

口 没有 测试 。 

首先 ， 我 们 要 确认 这 个 项 目 根本 没有 测试 过 ; 项 目 中 没有 test 文 件 夹 印证 了 这 点 : 


$ find src/test 
find: src/test: No such file or directory 


下 面 列 出 Java 部 分 的 文件 夹 : 





$ cd src/main/java/com/packtpublishing/tddjava/ch08/alexandria/ 
$ find . 


./Book.java 

./Books . java 
./BooksEndpoint .java 
./BooksRepository.java 
./CustomExceptionMapper.java 
./MyApplication.java 
./States.java 

./User.java 
./UserRepository.java 
./Users.java 


其 他 部 分 的 文件 夹 如 下 所 示 : 


$ cd src/main 

$ find resources webapp 
resources 
resources/applicationContext .xml 
webapp 
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webapp/WEB-INF 
webapp/WEB-INF/web.xml 


这 好 像 是 个 Web 项 目 (文件 web.xml 表 明了 这 一 点 )， 使 用 的 是 Spring ( application- 
Context .xml 表 明了 这 一 点 )。 下 面 列 出 了 pom.xml 包 含 的 部 分 依赖 : 


<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-web</artifactId> 
<version>4.1.4.RELEASE</version> 
</dependency> 


其 中 有 Spring， 这 是 个 好 兆头 ， 因 为 它 可 帮助 注 和 依赖， 但 快速 调查 表明 并 没有 真正 使 用 这 
个 上 下 文 。 英 非 这 是 以 前 使 用 的 ? 


在 文件 web .xml 中 ， 我 们 发 现 了 如 下 片段 : 











<?xml] version="1.0" encoding="UTF-8"?> 

<web-app version="3.0" xmlns="http://java.sun.com/xml/ns/javaee" 
xmlns:xsi="http://www.w3.o0rg/2001/xMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"> 


<module-name>alexandria</module-name> 


<context-param> 
<param-name>contextConfigLocation</param-name> 
<param-value>classpath:applicationContext.xml</param-value> 
</context-param> 


<servlet> 
<servlet-name>SpringApplication</servlet-name> 
<servlet-class> 
org.glassfish.jersey.servlet.ServletContainer</servlet-class> 
<init-param> 
<param-name>javax.ws.rs.Application</param-name> 
<param-value>com.packtpublishing.tddjava.ch08.alexandria.MyApplication 
</param-value> 
</init-param> 
<load-on-startup>1</load-on-startup> 
</servlet> 


这 个 文件 表明 : 


口 将 加 载 applicationContext .xml 中 的 上 下 文 ; 
口 将 在 一 个 servlet 中 执行 应 用 程序 文件 com.packtpublishing.tddjava.ch08. Alexa 
ndria.MyApplicationo 





文件 MyApplication 的 内 容 如 下 所 示 : 


public class MyApplication extends ResourceConfig { 
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public MyApplication() { 
register(RequestContextrFilter.class); 
register (BooksEndpoint.class); 
register(JacksonJaxbJsonProvider.class); 
register (CustomExceptionMapper.class); 


} 
它 配置 必要 的 类 ， 以 便 执行 端点 BooksEndpoint ( 片段 ): 





@Path ("books") 
@Component 
public class BooksEndpoint { 


private BooksRepository books = new BooksRepository () ; 


private UserRepository users = new UserRepository(); 


个 代码 片段 中 ， 我 们 发 现 了 遗留 代码 的 特征 之 一 : 两 个 依赖 (books 和 users ) 都 是 在 端 
is 而 不 是 注入 的 。 这 导致 单元 测试 更 为 困难 。 


我 们 可 记录 重 构 期 间 要 使 用 的 元 素 ， 以 便 后 面 编写 将 依赖 注入 BoeoksEndpoint 的 代码 。 
1. 如 何 确定 可 重 构 的 地 方 


编程 范式 〈 如 函数 式 、 命 令 式 和 面向 对 象 ) 和 风格 ( 如 简洁 、 详 尽 、 极 简 和 自 恋 ) 很 多 ， 可 
重 构 的 地 方 因 人 而 异 。 

确定 可 重 构 的 地 方 时 ， 还 有 一 种 与 主观 相反 的 方式 : 客观 的 方式 。 有 研究 论文 探讨 了 这 些 方 
式 ， 如 http:/wwwi.bth.se/fou/cuppsats.nsf/all/2e48c5bclc234d0ec1257c77003ac842/$file/BTH2014SIV- 
ERLAND pdf。 















































2. 引入 新 功能 
对 代码 有 更 深入 的 了 解 后 , 看 起 来 最 重要 的 功能 更 改 是 , 将 当前 使 用 的 单个 状态 ( 即 以 下 代 
码 片 段 ): 


@xmlRootElement 
public class Book { 








private final String title; 
private final String author; 
private int status; // 这 是 一 个 属性 
private int igd; 


替换 为 状态 集合 ( 即 下 面 的 代码 片段 ): 


@xmlRootElement 
public class Book { 
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Private int[] statuses; 
J es 


这 看 起 来 管用 ( 将 对 字段 的 访问 改 为 对 数组 的 访问 后 )， 但 也 提出 了 另 一 个 功能 需求 。 
软件 Alexandria 必 须 能 够 存储 图 书 并 将 其 借 给 能 够 归还 的 用 户 。 用 户 还 能 在 这 个 系统 中 根据 
作者 、 书 名 、 状 态 和 ID 搜索 图 书 。 
产品 所 有 者 (PO ) 确认 现在 根据 状态 搜索 图 书 的 方式 变 了 : 现在 还 允许 搜索 以 前 的 状态 。 
这 导致 需要 做 的 修改 越 来 越 多 。 每 当 觉 得 该 将 遗留 代码 删除 时 , 我 们 就 开始 应 用 遗留 代码 修 
改 算法 O 
我 们 还 发 现 了 坏 味 “ 依 恋情 结 ”和 “基本 类 型 偏执 ": 使 用 int 变 量 存储 状态 ( 基本 类 型 偏执 )， 
并 修改 另 一 个 对 象 的 状态 〈 依恋 情结 )。 我 们 将 这 个 可 重 构 的 地 方 加 入 待 办 事项 清单 。 
口 将 依赖 注 人 BooksEndpoint; 
口 将 单个 状态 改 为 多 个 状态 ; 
口 消除 状态 的 “基本 类 型 偏执 ” 坏 味 (可 选 )。 




















8.2.7 ”应 用 人 遗留 代码 修改 算法 


在 这 里 ， 整 个 后 端 是 独立 工作 的 ， 它 使 用 的 是 内 存 持 久 化 ; 即便 数据 被 保存 到 数据 库 ， 也 可 
使 用 同样 的 算法 ,但 需要 编写 一 些 额 外 的 代码 ， 用 于 在 测试 之 间 清 理 和 填充 数据 库 。 


我 们 将 使 用 DbUnit， 有 关 这 个 测试 框架 的 更 详细 信息 ， 请 参阅 http://dbunit.sourceforge.net/。 





























1. 编写 端 到 端 测试 用 例 


为 确保 行为 在 重 构 期 间 不 变 ,我 们 决定 首先 编写 端 到 端 测试 ,对 于 其 他 包含 前 端的 应 用 程序 ， 
可 使 用 更 高 级 的 工具 ( 如 Selenium/Selenide ) 完成 这 项 工作 。 


在 这 里 ， 由 于 前 端 不 需要 重 构 ， 因 此 可 使 用 较 低 级 的 工具 。 我 们 选择 编写 HITP 请 求 进行 端 
到 测试 8 


这 些 请 求 应 是 自动 的 、 可 测试 的 ， 因此 应 遵循 所 有 自动 测试 规则 。 鉴 于 要 在 编写 这 些 测试 的 
同时 探索 应 用 程序 的 实际 行为 ， 我 们 决定 使 用 工具 Postman ( 这 个 工具 可 在 如 下 网 址 找到 : 
https://chrome.google.com/webstore/detail/postman-rest-client/fdmmgilgnpjigdojojpjoooidkmcomcem, 
其 官网 为 https:/www.getpostman.com/ ) 编写 一 个 尖峰 冲击 。 也 可 使 用 工具 curl( http://curl.haxx.se/ ) 
编写 尖峰 冲击 。 
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curl 是 什么 ? 
curl 是 一 个 使 用 URL 语 法 传输 数据 的 命令 行 工 具 和 库 ， 支 持 ...HTTP、 


HTTPS、 ... HTTP POST、 HTTP PUT...。 


curl 有 何 用 途 呢 ? 


可 在 命令 行 或 脚本 中 使 用 curl 传 输 数 据 。 


为 此 ， 我 们 决定 使 用 如 下 命令 ， 在 本 地 执行 这 个 


mvn clean jetty:run 
这 将 启动 一 个 处 理 请 求 的 本 地 jetty 服 务 器 。 这 样 做 的 最 大 好 处 是 ， 部 署 是 自动 完成 的 ， 无需 
将 一 切 打包 并 手动 将 其 部 署 到 应 用 程序 服务 器 ( 如 JBoss AS 、GlassFish 、Geronimo 或 TomEE )。 
这 可 极 大 提高 修改 并 查看 效果 的 速度 ， 从 而 缩短 反馈 时 间 。 在 本 章 后 面 ， 我 们 将 在 Java 代 码 中 以 




















编程 方式 启动 这 个 服务 骨 。 





先 确 定 有 哪些 功能 。 在 本 章 前 面 ， 我 们 发 现 Books] 
从 这 里 着 手 确定 有 哪些 功能 是 不 错 的 选择 。 发 现 的 功能 如 下 。 





























一 一 摘自 http://curl.haxx.se/ 











(1) 添加 新 书 。 

(2) 列 出 所 有 图 书 。 

(3) 根据 ID、 作 者 、 书 名 和 状态 搜索 图 书 。 

(4) 为 出 租 图 书 做 准备 。 

(5) 出 租 图 书 。 

(6) 将 图 书 下 架 。 

(7) 将 图 书 重新 上 架 。 

我 们 手动 启动 服务 器 ， 并 开始 编写 请 求 。 
ED add book 
Balbooks 


ED censor book 1 

[Ger | get book by author 

| GET | get book id= 1 

| GET get book state does not exist 
[Ger | get book title does not exist 
ED prepare book 1 

ED rent book 1 by user 

ED retum book 1 

ED uncensor book 1 











Endpoint 类 包含 Web 服 务 端点 的 定义 ， 
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这 些 测试 看 起 来 足以 达到 尖峰 冲击 的 目的 。 我 们 注意 到 每 个 响应 都 包含 时 间 戳 , 这 让 自动 化 
更 为 辐 手 。 








all books 


http://localhost:8080/alexandria/books 


| send | Save Preview Add to collection 
Body FI WU 202 Accepted TIME | 286 ms 


Pretty | Raw Preview ml 寺 JSON | XML 


{ 
"empty": false, 
"requestTime": "18:47:59.838", 
"result": 
{ | 
"title": "TDD in Java”, 
"author": "Viktor Farcic & Alex Garcia", 
"status": 1, 
"id": 9 
}， 
{ 
"title": "TDD in Java”, 
“author": "Viktor Farcic & Alex Garcia", 
"status": 1, 
“ds 
} 
7 ] 
} 














测试 要 更 有 价值 ,必须 自动 化 并 面面俱到 。 但 当前 不 是 这 样 的 ， 因 此 我 们 将 它们 视 为 尖峰 冲 
击 。 本 章 后 面 将 自动 化 这 些 测试 。 











我 们 执行 的 每 个 测试 都 不 是 自动 化 的 ， 但 在 这 里 ， 使 用 Postman 界 面 编写 测 
试 的 速度 比 自动 化 测试 快 得 多 。 另外, 与 实际 使 用 这 个 产品 相 比 ， 获 得 的 体验 也 
更 有 代表 性 。 测 试 客户 端 可 能 给 产品 带 来 问题 ， 导 致 返回 的 结果 不 可 信和 。 

此 处 ， 我们 发 现 使 用 Postman 测 试 是 更 合算 的 投资 ， 因 为 使 用 完毕 将 丢弃 这 
~ 些 测试 。 这 些 测试 以 极 快 的 速度 提供 有 关 API 的 反馈 和 结果 。 我 们 还 使 用 Postman 

创建 REST API 原 型 ， 因 为 它 提供 的 工具 既 有 效 又 管用 

一 般 而 言 , 根据 是 否 需要 将 测试 留 到 以 后 使 用 而 选择 不 同 工 具 ; 需要 考虑 的 
因素 还 包括 测试 的 执行 频率 以 及 执行 环境 。 


执行 前 述 请 求 后 ， 我 们 发 现 了 这 个 应 用 程序 的 一 些 状 态 ， 如 下 图 所 示 。 
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通过 尖峰 冲击 对 应 用 程序 有 所 了 解 后 ,该 自动 化 测试 了 。 毕 竟 ， 如 果 不 自动 化 测试 ， 就 不 能 
信心 满 满 地 去 重 构 。 


2. 自动 化 测试 用 例 








我 们 将 以 编程 方式 启动 服务 器 。 为 此 ， 使 用 Grizzly ( https://grizzly.java.net/ )， 它 让 我 们 能 够 

















使 用 来 自 Jersey ResourceConfig ( FQCN: org.glassfish.jersey. server.ResourceConfig ) 的 配置 以 启动 
服务 器 ， 如 测试 类 BooksEndpointTest 所 示 (这 只 是 一 个 片段 ， 完 整 的 源 代 码 可 在 


https://bitbucket. 





org/vfarcic/tdd-chapter-08/commits/branch/refactor/inject-dependencies 找 到 ): 


public class BooksEndpointTest { 
public static final URI FULL_ PATH = 


URI. 


create("http://localhost:8080/alexandria"); 


private HttpServer server; 


@Before 
public void setUp() throws IOException { 
ResourceConfig resourceConfig = 


new MyApplication(); 


server = GrizzlyHttpServerFactory 


.CreateHttpServer (FULL_ PATH, resourceConfig); 


server.start () ; 


} 


@After 
public void tearDown()f{ 
server.shutdownNow(); 


} 


这 些 代 码 启动 一 个 本 地 服务 器 ， 其 地 址 为 http:/localhost:8080/alexandria。 这 个 服务 器 仅 在 
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很 短 的 时 间 内 (测试 运行 时 ) 可 用 ， 因 此 如 果 你 需要 手动 访问 ， 请 在 需要 暂停 执行 时 调用 下 面 
的 方法 : 


public void pauseTheServer() throws Exception { 
System.in.read(); 


} 

如 果 要 停止 这 个 服务 器 ， 可 停止 执行 ， 也 可 在 控制 台 按 回 车 键 。 

现在 我 们 能 够 以 编程 方式 启动 这 个 服务 器 , 请 ( 使 用 前 面 的 方法 ) 将 其 暂停 ， 并 再 次 执行 前 
面 的 尖峰 冲击 。 结 果 没 变 ， 说 明 重 构成 功 。 


下 面 给 系统 添加 第 一 个 自动 化 测试 ( 代码 可 在 https://bitbucket.org/vfarcic/tdd-chapter-08/ 


commits/branch/refactor/inject-dependencies 找 到 ); 





























public class BooksEndpointTest { 


public static final String AUTHOR_ BOOK_1 = 
"Viktor Farcic and Alex Garcia"; 

bublie statie, final’ String. TITLE: BOOK 1 三 
"TDD in Java"y 

private final Map<String, String> TDD_IN_JAVA; 


public BooksEndpointTest() { 
TDD_IN_JAVA = getBookProperties (TITLE_ BOOK_1, 
AUTHOR_BOOK_1) ， 
} 


private Map<String, String> getBookProperties 
(String title, String author) { 
Map<String, String> bookProperties = 
new HashMap<>(); 
bookProperties.put ("title", title); 
bookProperties.put ("author", author); 
return bookProperties; 


} 


@Test 

public void adqd_one book() throws IOException { 
final Response pooks1 = addBook (TDD_IN_JAVA); 
assertBooksSize(books1l, is("1")); 


private void assertBooksSize(Response response, 
Matcher<String> matcher) { 
response.then() .body (matcher); 


} 


private Response addBook 
(Map<String, ?> bookProperties) { 
return RestAssured 
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.given().10g() .path() 
.ContentType (ContentType.URLENC) 
.barameters (bookProperties) 
.post ("books"); 

} 


为 进行 测试 ,我 们 使 用 了 一 个 名 为 RestAssured 的 库 ( https://code.google.com/p/rest-assured/ )， 
它 让 我 们 能 够 更 轻松 地 测试 REST 和 JSON。 

为 完成 这 个 自动 化 测试 套件 ， 我 们 创建 如 下 测试 : 

(1)adgd_one_book () 

(2) add_a_secongd_ book () 

(3) get_book_ details_by_id!() 

(4) get_several_ books_in a_row!() 


($5) censor_a_book () 





(6) cannot_retrieve a censored_ book!() 


可 在 https://bitbucket.org/vfarcic/tdd-chapter-08/commits/branch/refactor/inject-dependencies 找 到 
它们 的 代码 。 


有 了 确保 不 会 导致 退化 的 测试 套件 后 ， 下 面 查看 待 办 事项 清单 : 


口 将 依赖 注 人 BooksEndpoint; 
口 将 单个 状态 改 为 多 个 状态 ; 
口 消除 状态 的 “基本 类 型 偏执 ” 坏 味 ( 可 选 )。 


先 处 理 依赖 注入 。 
3. 注入 依赖 BookRepository 
依赖 BookRepository 是 在 BooksEndpoint 中 创建 的 ， 如 下 代码 片段 所 示 : 



































@Path ("books") 
@Component 
public class BooksEndpoint { 


private BooksRepository books = 


new BooksRepository(); 


[ss] 


8.2.8 ”提取 并 重 写 调用 


我 们 将 使 用 前 面 介绍 的 重 构 方法 “提取 并 重 写 调 用 "。 为 此 ， 创 建 一 个 失败 的 规范 ， 如 下 
所 示 : 
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@Test 
public void add_one book() throws IOException { 
addBook (TDD_IN_JAVA); 


Book tddInJava = new Book (TITLE_ BOOK_1, 
AUTHOR_BOOK_1， 
States.fromValue(1)); 


verify(booksRepository) .add (tddIinJava); 
} 


为 让 这 个 处 于 红 灯 状 态 的 规范 ( 失败 的 规范 ) 通过 ,首先 提出 创建 依赖 的 代码 ， 并 将 其 放 在 
BookRepository 类 的 一 个 受 保护 的 方法 中 : 
@Path ("books") 


@Component 
public class BooksEndpoint { 

















private BooksRepository books = 
getBooksRepository () ; 


[本 | 


protected BooksRepository 
getBooksRepository() { 
return new BooksRepository(); 


} 
Ea 
复制 启动 器 MyApplication 的 代码 : 


public class TestApplication 
extends ResourceConfig { 


public TestApplication 
(BooksEndpoint booksEndpoint) { 
register (booksEndpoint); 
register (RequestContextFilter.class); 
register(JacksonJaxbJsonProvider.class); 
register (CustomExceptionMapper.class); 





} 
public TestApplication() { 
this(new BooksEndpoint( 


new BooksRepository())); 


} 





这 让 我 们 能 够 注入 任何 BooksEndpoint 。 这 个 示例 中 ， 我们 将 在 BooksEngdpoint- 
InteractionTest 中 重 写 依赖 获取 方法 。 这 样 就 能 检查 是 否 调 用 了 必要 的 方法 ， 如 Books- 
EndpointInteractionTest 中 的 下 述 代码 片段 所 示 : 
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@Test 
public void add one book() throws IOException { 


addBook (TDD_IN_JAVA); 
verify (booksRepository) 
.add (new Book (TITLE_ BOOK_1, 
AUTHOR_BOOKR_1, 1)); 
运行 测试 , 一 路 绿灯 。 虽 然 规范 都 通过 了 , 但 我 们 引入 了 一 个 仅 用 于 测试 的 设计 片段 ; 可 是 


产品 代码 不 会 执行 新 增 的 启动 器 TestApplication, 而 依然 执行 旧 启 动 器 MyApplication。 要 
解决 这 个 问题 ， 我 们 并 需 将 这 两 个 启动 器 合 而 为 一 。 为 此 ， 可 使 用 重 构 方 法 “参数 化 构造 函数 ， 
这 在 Roy Osherove 的 著作 《单元 测试 的 艺术 》( http:/www.ituring.com.cn/book/1336 ) 中 也 有 介绍 。 











@ 参数 化 构造 吕 数 


我 们 可 将 接受 依赖 BooksEndqpoint 的 启动 器 合 而 为 一 : 如 果 没 有 指定 依赖 ， 就 使 用 实际 的 
BooksRepository 实 例 注册 依赖 ， 否 则 注册 收 到 的 依赖 : 





public class MyApplication 
extends ResourceConfig { 


public MyApplication() { 
this(new BooksEndpoint( 
new BooksRepository())); 


} 


public MyApplication 
(BooksEndpoint booksEndpoint) { 
register (booksEndpoint); 
register (RequestContextFilter.class); 
register(JacksonJaxbJsonProvider.class); 
register (CustomExceptionMapper.class); 


} 
在 这 里 ,我 们 使 用 “构造 函数 串 接 ” 避 人 免 构 造 函 数 包含 重复 代码 。 


执行 这 种 重 构 后 ，BooksEndpointInteractionTest 类 如 下 所 示 ( 这 种 最 终 版 本 ): 








public class BooksEndpointIinteractionTest { 


public static final URI FULL_ PATH = URI. 
create("http://localhost:8080/alexandria"); 

private HttpServer server; 

private BooksRepository booksRepository; 


@Before 
public void setUp() throws IOException { 
booksRepository = mock (BooksRepository.class); 
BooksEndpoint booksEndpoint = 
new BooksEndpoint (booksRepository); 
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ResourceConfig resourceConfig = 
new MyApplication(booksEndpoint); 
server = GrizzlyHttpServerFactory 
.CreateHttpServer (FULL_ PATH, resourceConfig); 
server.start (); 


} 
一 个 测试 通过 ， 因 此 可 将 依赖 注入 任务 标记 为 “已 完成 ”。 
代办 事项 清单 如 下 : 


口 将 依赖 注 人 BooksEndpoint; 
口 将 单个 状态 改 为 多 个 状态 ; 
口 消除 状态 的 “基本 类 型 偏执 ” 坏 味 (可 选 )。 


添加 新 功能 

有 了 必要 的 测试 环境 后 ， 即 可 添加 新 功能 。 

给 定 一 本 图 书 ， 图 书 管理 员 想 知道 其 完整 的 出 借 历史 ， 以 确定 哪些 图 书 更 受 欢迎 。 
首先 编写 一 个 不 能 通过 的 规范 : 




















Ri 























public class BooksSpec { 





@Test 
public void should search for _ any_ past_state() { 
Book bookl = new Book("title", "author", 


States.AVAILABLE); 
bookl .censor () ; 


Books books = new Books(); 
books.add (book1) ; 


String available = 
String.valueOf (States .AVAILABLE); 
assertThat ( 
books.filterByState(available) .isEmpty(), 
is(false)); 








一 


运行 所 有 测试 ， 发 现 最 后 一 个 失败 。 
实现 根据 各 种 状态 进行 搜索 的 功能 : 
public class Book { 

private ArrayList<Integer> status; 


public Book(String title, String author, int status) { 
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泪 
Oo 
地 





Enis ytitle: iTtLeS 
this.author = author; 
this.status = new ArrayList<>(); 
this.status.add (status); 

} 


public int getStatus() { 
return status.get (status.size()-1); 


} 


public void rent() { 
status.add(States.RENTED); 

} 

Bl 


public List<Integer> anyState() { 
return status; 

} 

[ ] 


这 个 代码 片段 中 ,我 们 没有 列 出 不 相关 的 部 分 : 未 修改 的 或 以 类 似 方 式 修改 实现 的 方法 ( 如 rent )。 


public class Books { 
public Books filterByState(String state) { 
Integer expectedState = Integer.valueOf (state); 
return new Books ( 
new ConcurrentLinkedQueue<>( 
books.stream!() 
.filter(x 
-> x.anyState() 
.contains (expectedState)) 
.Collect (toList()))); 





} 
[ ] 


外 部 方法 ( 尤其 是 序列 化 为 ISON 的 方法 ) 不 受 影响 ， 因 为 方法 getstatus 的 返回 类 型 
依然 是 int。 


运行 所 有 测试 ， 发 现 一 路 绿灯 。 
代办 事项 清单 如 下 : 


口 将 依赖 注 人 BooksEndpoint; 
口 将 单个 状态 改 为 多 个 状态 ; 
口 消除 状态 的 “基本 类 型 偏执 ” 坏 味 ( 可 选 )。 





9 一 
































8.2.9 ”消除 状态 的 “基本 类 型 偏执 ” 坏 味 
我 们 决定 ， 也 要 完成 待 办 事项 清单 中 的 可 选项 。 
代办 事项 清单 如 下 : 
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口 将 依赖 注 人 BooksEndpoint; 
口 将 单个 状态 改 为 多 个 状态 ; 
口 消除 状态 的 “基本 类 型 偏执 ” 坏 味 (可 选 )。 





“基本 类 型 偏执 ” 坏 味 指 的 是 使 用 基本 数据 类 型 表示 域 概念 。 例 如 ， 使 用 字 
符 串 表示 消息 ， 使 用 整数 表示 金额 ， 使 用 结构 体 /字典 / 散 列 表示 对 象 。 
一 一 摘自 http://c2.com/cgi/wiki?PrimitiveObsession 

















这 是 一 个 重 构 步骤 ( 即 不 会 在 系统 中 引入 新 行为 )， 因 此 不 需要 编写 新 规范 。 我 们 将 力 保 始 
终 处 于 绿灯 状态 ， 或 不 处 于 绿灯 状态 的 时 间 很 短 。 


当前 ，states 是 一 个 包含 常量 的 java 类 ， 如 下 所 示 : 

















public class States { 
public static final int BOUGHT = 1; 
public static final int RENTED = 2; 
public static final int AVAILABLE = 3; 
public static final int CENSORED = 4; 


enum States { 
BOUGHT (1), 
RENTED (2), 
AVAILABLE (3), 
CENSORED (4); 


private final int value; 


private States(int value) { 
this.value = value; 


} 


public int getValue() { 
return value; 


} 





public static States fromValue(int value) { 
for (States states : values()) { 
if(states.getValue() == value) { 
return states; 
} 
} 
throw new IllegalArgumentException!( 
"Value '" + Value 
+ "' could not be foungd in States"); 


} 
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再 将 测试 相应 修改 如 下 : 








public class BooksEndpointIinteractionTest { 
@Test 
public void add_ one book() throws IOException { 
addBook (TDD_IN_JAVA); 
verify (booksRepository) .add( 
new Book (TITLE_ BOOK_1, AUTHOR_BOOK_1, 
States.BOUGHT) ); 
} 
Ls ss] 
public class BooksTest { 





@Test 
public void should search for_ any past_state() { 
Book book1 = new Book("title", "author", 


States.AVAILABLE); 
book1 .censor(); 


Books books = new Books(); 
books.add (book1); 


assertThat (books.filterByStatel 
String.valueOf ( 
States.AVAILABLE.getValue())) 
.isEmpty(), is(false)); 
} 
Bea 


接 下 来 ， 修 改 产品 代码 ， 如 下 代码 片段 所 示 : 


@xmlRootElement 
public class Books { 
public Books filterByState(String state) { 
State expected = 
States.fromValue (Integer.valueOf (state)); 
return new Books ( 
new ConcurrentLinkedQueue<>( 
books.stream!() 
.filter(x -> X.anyState() 
.contains (expected)) 
.collect (toList()))); 
} 
| 


还 有 如 下 代码 片段 : 


@xmlRootElement 
public class Book { 


private final String title; 


private final String author; 
@xmlTransient 
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private ArrayList<States> status; 
private int id; 


public Book 
(String title, String author, States status) { 


this:titie = title> 

this.author = author; 
this.status = new ArrayList<>(); 
this.status.add (status); 


} 





public States getStatus() { 
return status.get (status.size() - 1); 


} 


@xmlElement (name = "status") 
public int getStatusAsInteger(){ 

return getStatus() .getValue(); 
} 


public List<States> anyState() { 
return status; 

} 

Eas A 


在 这 里 ， 序 列 化 是 使 用 注解 实现 的 : 
@xmlElement (name = "status") 


将 方法 的 结果 转换 为 status 字 段 。 




















另外 ， 对 于 字段 status (现在 为 ArravList<States>， 使 用 exmlTransient 进 行 标记 ， 
因为 它 不 会 序列 化 为 JSON。 


执行 所 有 测试 ， 它 们 都 通过 了 ， 因 此 现在 可 以 将 待 办 事项 清单 中 的 可 选项 也 勾 掉 。 
待 办 事项 清单 如 下 : 


口 将 依赖 注入 BooksEndpoint; 
口 将 单个 状态 改 为 多 个 状态 ; 
口 消除 状态 的 “基本 类 型 偏执 ” 坏 味 (可 选 ) 











8.3 小 结 
你 知道 ， 接 手 遗 留 代码 库 可 能 是 一 项 令 人 导 步 的 任务 。 


本 章 前 面 说 过 ， 遗留 代码 是 不 带 测 试 的 代码 。 因 此 要 处 理 遗 留 代码 ,首先 需要 创建 测试 ， 确 
保 遗 留 代码 的 功能 在 处 理 过 程 中 保持 不 变 。 
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遗憾 的 是 , 创建 测试 并 非 总 是 那么 容易 。 遗 留 代码 通常 紧密 耦合 , 还 存在 昭示 着 设计 不 善 ( 至 
少 以 前 没 关 心 过 代码 质量 ) 的 症状 。 但 不 用 担心 ， 你 可 逐步 执行 一 些 繁琐 的 步 又 ， 详 情 请 参阅 
http:/martinfowler.comybliki/ParallelChange.html。 另 外 ， 众 所 周知 ， 软 件 开发 就 是 一 个 学 习 过 程 ， 
能 够 正确 运行 的 代码 不 过 是 这 个 过 程 的 副产品 。 因 此, 最 重要 的 是 更 深入 地 了 解 代 码 库 ， 以 便 能 
够 安全 修改 。 更 详细 的 信息 请 参阅 http://www.slideshare.net/ziobrando/model-storming。 









































最 后 ， 强 烈 建议 你 阅读 Michael Feathers 的 著作 《修改 代码 的 艺术 》 其 中 介绍 了 大 量 处 理 遗 
留 代码 库 的 技巧 ， 对 理解 整个 过 程 大 有 神 益 。 
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“不 要 受 环境 控制 ， 去 改变 环境 。” 
一 成 龙 

至 此 ,你 知道 TDD 让 开发 过 程 更 容易 ,还 可 缩短 编写 高 质量 代码 所 需 的 时 间 。 它 还 能 带 来 另 
一 个 好 处 : 由 于 代码 经 过 了 测试 ， 其 正确 性 得 到 广泛 证 明 ， 因 此 我 们 可 进一步 认为 ， 所 有 测试 都 
通过 后 ， 便 可 将 代码 部 署 到 生产 环境 。 

有 一 些 基于 这 种 理念 的 软件 生命 周期 方法 。 本 章 将 介绍 一 些 极限 编程 实践 ， 如 持续 集成 、 持 
续 交 付 和 持续 部 置 。 

本 章 涵盖 如 下 主题 : 


D 持续 集成 、 持 续 交付 和 持续 部 团 ; 
D 在 生产 环境 中 测试 应 用 程序 ; 
D 功能 开关 。 



































9.1 持续 集成 、 持 续 交 付 和 持续 部 署 


测试 驱动 开发 与 持续 集成 ( CI )、 持 续 交 付 和 持续 部 署 (CD ) 相辅相成 。 持 续集 成 、 持 续 交 
付 和 持续 部 署 虽 然 有 些 差别 ,但 它们 的 目标 类 似 ， 即 都 力图 不 断 验 证 代码 可 否 部 署 到 生产 环境 。 
从 这 种 意义 上 说 , 它们 与 IDD 很 像 ， 都 提倡 采用 极 短 的 开发 周期 持续 验证 当前 编写 的 代码 ， 忆 在 
确保 应 用 程序 始终 处 于 可 部 署 到 生产 环境 的 状态 。 

由 于 篇 幅 有 限 , 本 书 无 法 详细 介绍 这 些 技术 。 实 际 上 ， 有 关 这 个 主题 可 编写 一 部 专著 。 这 里 
只 介绍 这 三 种 技术 的 差别 。 持 续集 成 意味 着 始终 将 代码 与 系统 的 其 他 部 分 集成 起 来 , 让 问题 快速 
浮 出 水 面 。 发 现 问题 后 ， 将 优先 修复 导致 问题 的 原因 ， 推 后 新 的 开发 工作 。 你 可 能 注意 到 ， 这 个 
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定义 与 TDD 的 工作 原理 类 似 , 主要 差别 在 于 TDD 的 关注 点 并 非 与 系统 其 他 部 分 的 集成 , 此 外 的 方 
面 都 相同 。 TDD 和 持续 集成 都 力图 快速 发 现 问题 , 并 将 修复 问题 放 在 最 优先 的 位 置 一 一 其 他 事情 
都 得 靠边 站 。 持续 集成 并 未 将 整个 流水 线 都 自动 化 一 一 将 代码 部 署 到 生产 环境 前 , 需要 执行 额外 
的 手动 验证 。 


持续 交付 很 像 持续 集成 ,但 比 后 者 更 进一步 ,将 整个 流水 线 都 自动 化 ( 部 署 到 生产 环境 除外 )。 
每 次 将 代码 提交 到 仓库 并 通过 所 有 验证 后 , 便 可 部 署 到 生产 环境 。 然 而 , 部 署 决策 是 人 工 完成 的 ， 
需要 有 人 选择 要 部 署 到 生产 环境 的 构建 。 选 择 是 基于 策略 或 功能 的 , 即 要 将 哪个 构建 提供 给 用 户 
以 及 何 时 提供 一 一 虽然 所 有 构建 都 可 部 署 到 生产 环境 。 



































“持续 交付 是 一 种 软件 开发 准则 ， 通 过 采用 合适 的 开发 方式 确保 软件 在 任何 时 候 痢 
可 发 布 到 生产 环境 .” 





Martin Fowler 
最 后 ， 如 果 有 关 部 署 内 容 的 决策 也 是 自动 做 出 的 ， 持 续 交 付 就 变 成 持续 部 署 。 这 种 情况 下 ， 
每 次 提交 代码 后 ， 如 果 通 过 所 有 验证 就 将 部 署 到 生产 环境 ， 无 一 例外 。 


要 持续 将 代码 交付 到 生产 环境 ， 必 须 满足 如 下 条 件 : 要 么 没有 分 支 ， 要 么 分 支 从 被 创建 到 
被 集成 到 主干 (mainline ) 的 时 间 很 短 (不 超过 一 天 ,最 好 只 有 儿 小 时 ); 否则 就 不 能 持续 验证 
代 人 码 [eo 


提交 代码 前 必须 创建 验证 , 这 是 将 这 些 技术 与 TDD 联 系 起 来 的 纽带 。 如 果 不 预先 创建 这 些 验 
证 ， 提 交 到 仓库 的 代码 将 没有 配套 测试 ， 整 个 过 程 将 以 失败 告终 。 如 果 没 有 测试 ,我 们 就 没 法 对 
开发 的 代码 充满 信心 ; 如 果 没 有 TDD,， 就 没有 与 实现 代码 配套 的 测试 。 还 有 男 一 种 选择 一 一 推迟 
提交 ， 即 等 到 测试 创建 后 再 提交 到 仓库 。 但 这 样 做 根本 谈 不 上 “持续 ”: 测试 编写 好 之 前 ， 代 码 
一 直 存 储 在 开发 人 员 的 计算 机 中 ， 根 本 无 法 持续 对 整个 系统 进行 验证 。 


总 之 , 持续 集成 、 持 续 交 付 和 持续 部 署 依赖 于 与 实现 代码 配套 的 测试 ， 即 依赖 于 TDD， 还 要 
求 不 使 用 分 支 或 确保 分 支 的 存活 时 间 极 短 〈 被 频繁 地 合并 到 主干 )。 问 题 是 ， 有 些 功 能 并 不 能 在 
那么 短 的 时 间 内 开发 出 来 。 不 管 功能 多 小 ， 有 可 能 都 需要 几 天 的 开发 时 间 ; 在 此 期 间 , 我 们 不 能 
将 其 提交 到 仓库 ,否则 它们 将 被 交付 到 生产 环境 一 一 用 户 可 不 想 看 到 不 完整 的 功能 。 例 如， 交付 
不 完整 的 登录 功能 毫 无 意义 ; 如 果 用 户 看 到 一 个 登录 页 面 ， 其 中 包含 用 户 名 和 密码 文本 框 ,还 有 
一 个 登录 按钮 ， 而 单 击 这 个 按钮 并 不 能 存储 输入 的 信息 并 生成 身份 验证 cookie， 那 么 即便 在 最 好 
的 情况 下 ,这 也 只 会 让 用 户 感到 迷惑 。 有些 功 能 在 没有 其 他 功能 的 情况 下 不 管用 ; 继续 前 面 的 例 
子 ， 即 便 登 录 功 能 开发 好 了 ， 如 果 没 有 注册 功能 ， 它 也 之 无 意义 。 


想 想 玩 拼 图 的 情况 吧 。 你 需要 对 最 终 拼 出 来 的 图 形 有 大 致 认识 ,但 每 次 都 专注 于 一 块 拼图 。 
你 选择 自己 认为 最 容易 确定 位 置 的 拼图 ， 并 将 其 与 周边 的 拼图 合并 。 仅 当 所 有 拼图 都 各 就 各 位 ， 
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完整 的 图 形 才能 出 现 ， 至 此 大 功 告 成 。 

TDD 亦 如 此 。 我们 通过 每 次 专注 于 一 个 小 单元 来 开发 代码 。 随 着 工作 的 进行 ,整个 软件 初 具 
雏形 ,各 个 单元 相互 配合 ， 最 终 完 全 集成 。 整 个 过 程 结束 前 ， 即 便 所 有 测试 都 通过 ， 我 们 看 到 的 
是 绿灯 ， 也 不 能 将 代码 交付 给 最 终 用 户 。 

为 解决 这 些 问 题 ， 同 时 又 让 TDD 和 CICD 的 效果 不 打折 扣 ， 最 简单 的 办 法 就 是 使 用 功能 
开关 。 



























































9.2 ”功能 开关 


功能 开关 ( Feature Toggle ) 也 叫 功 能 切换 ( Feature Flipping ) 或 功能 标志 (Feature Flag )。 虽 
然 叫 法 不 同 , 但 它们 都 基于 这 样 一 种 机 制 ， 即 让 你 能 够 开启 和 关闭 应 用 程序 的 功能 。 所 有 代码 都 
被 合并 到 一 个 分 支 ， 而 你 必须 处 理 未 全 部 完成 ( 或 集成 ) 的 代码 时 ， 这 很 有 用 。 使 用 这 种 技巧 可 
隐藏 未 完成 的 功能 ， 让 用 户 无 法 访问 。 

这 种 功能 的 特征 使 它 还 有 其 他 用 途 : 在 功能 存在 问题 时 充当 断路 器 ， 让 应 用 程序 平稳 退化 ; 
关闭 次 要 功能 ,将 硬件 资源 留 给 核心 业务 。 有 些 情况 下 ， 功 能 开关 还 能 走 得 更 远 。 例 如 ,根据 用 
户 的 地 理 位 置 或 扮演 的 角色 决定 是 否 启用 特定 功能 。 另 一 个 用 途 是 仅 对 测试 者 启用 新 功能 ， 这样 
最 终 用 户 根本 不 知道 这 些 新 功能 的 存在 ， 同 时 让 测试 者 能 够 在 生产 服务 器 上 验证 。 


使 用 功能 开关 时 ， 需 要 牢记 一 些 要 点 : 



















































































口 仅 当 功能 已 部 署 并 确定 管用 后 才 使 用 开关 。 和 否则 代码 可 能 充斥 着 这 else 语 句 ， 这 些 语 句 包 
含 不 再 使 用 的 旧 开 关 。 

口 不 要 花 过 多 时 间 测 试 开 关 。 大 多数 情 况 下 ， 只 需 确定 新 功能 的 人口 不 可 见 即 可 ， 这 种 和 人 
口 可 能 是 到 新 功能 的 链接 。 

D 不 要 滥用 开关 。 不 要 在 不 需要 的 情况 下 使 用 开关 ， 例 如 ， 你 可 能 正在 开发 一 个 新 屏幕 ， 




















这 个 屏幕 可 通过 主页 中 的 一 个 链接 进行 访问 。 如 果 这 个 链接 位 于 主页 未 尾 ， 可 能 就 没有 
必要 使 用 开关 对 其 进行 隐藏 。 


用 于 处 理应 用 程序 功能 的 优秀 框架 和 库 有 很 多 ， 下 面 是 其 中 的 两 个 : 























口 Togglz (http:/www.togglz.org/ ); 
口 FF4J (http://ff4j.org/ )。 


这 些 库 提 供 了 复杂 的 功能 管理 方式 , 根据 角色 或 规则 决定 是 否 开启 功能 。 你 通常 不 需要 这 样 
复杂 的 功能 管理 方式 , 但 这 让 我 们 能 够 在 生产 环境 中 测试 新 功能 ， 同 时 不 对 所 有 用 户 都 开启 。 然 
而 ， 自 己 动手 实现 基本 的 功能 开关 解决 方案 很 容易 ， 我 们 将 通过 一 个 示例 证 明 。 
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9.3 功能 开关 示例 


下 面 来 看 演示 程序 。 我 们 将 创建 一 个 简单 的 小 型 REST 服 务 ， 它 根据 用 户 的 要 求 计 算 斐 波 那 
契 数 列 中 的 第 N 个 数 。 我 们 将 使 用 一 个 文件 记录 被 启用 /禁用 的 功能 。 出 于 简化 考虑 ， 使 用 
spring-boot 框 架 TT hynieleats 这 个 模版 引擎 包含 在 依赖 spring-boot 中 。 有 关 spring-boot 
及 相关 项 目的 更 详细 信息 ,请 参阅 http://projects.spring.io/spring-boot/; 有 关 模 版 引擎 Thymeleaf 的 
更 详细 信息 ， 请 参阅 http://www.thymeleaf.org/。 

















文件 builg.gradle 如 下 所 示 : 


apply plugin: 'Jjava' 
apply plugin: 'application' 


sourceCompatibility = 1.8 
version = '1.0' 
mainClassName = "com.packtpublishing.tddjava.ch09.Application" 


repositories { 
mavenLocal () 
mavenCentral () 


} 


dependencies { 
compile group: 'org.springframework.boot', 
name: 'spring-boot-starter-thymeleaf', 
version: '1.2.4.RELEASE' 


testCompile group: 'junit', 
name: 'junit', 
version: '4.12' 





意 ， 其 中 包含 插件 application， 因 为 我 们 要 使 用 Gradle 命 令 run 运 行 这 个 应 用 程序 。 这 
i 


@SpringBootApplication 
public class Application { 
public static void main(String[] args) { 
SpringApplication.run(Application.class, args); 





} 
} 


我 们 将 创建 属性 文件 。 为 此 ， 我 们 将 使 用 YAML 格 式 ， 因 为 它 简洁 且 很 容易 理解 。 请 在 文件 
夹 src/main/resources 中 添加 文件 application.yml， 并 在 其 中 添加 如 下 内 容 : 


features: 
fibonacci: 
restEnabled: false 


Spring 提供 了 一 种 自动 加 载 这 种 属性 文件 的 方式 。 当 前 只 有 两 个 约束 条 件 : 文件 的 名 称 必须 
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为 application.yml; 文件 必须 包含 在 应 用 程序 的 类 路 径 中 。 
下 面 是 功能 配置 文件 的 实现 : 


@Configuration 
@EnableConfigurationPproperties 
@Configurationproperties (prefix = "features.fibonacci") 
public class FibonacciFeatureConfig { 

private boolean restEnabled; 





public boolean isRestEnabled() { 
return restEnabled; 


public void setRestEnabled(boolean restEnabled) { 
this.restEnabled = restEnabled; 


} 
下 面 是 fiponacci 服 务 类 ， 当 前 其 计算 代码 总 是 返回 -1， 这 骨 在 模拟 一 项 未 完成 的 功能 : 




















@Service("fibonacci") 
public class FibonacciService { 


public int getNthNumber (int n) { 
return -1; 


} 
还 需要 一 个 用 于 存储 计算 结果 的 包装 器 : 





public class FibonacciNumber { 
private final int number, value; 


public FibonacciNumber (int number, int value) { 


this.number = number; 
this.value = value; 


public int getNumber() { 
return number; 


public int getValue() { 
return value; 


} 




















下 面 是 负责 处 理 fijbonacci 服 务 查 询 的 fijbonacciRESTController 类 : 





@RestController 
public class FibonacciRestController { 
@Autowired 
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FibonacciFeatureConfig fibonacciFeatureConfig; 


@Autowired 
@QOualifier ("fibonacci") 
private FibonacciService fibonacciprovider; 


@RequestMapping (value = "/fibonacci", method = GET) 
public FibonacciNumber fiponacci( 
QRequestParam( 
value = "number", 
defaultValue = "0") int number) { 
if (fibonacciFeatureConfig.isRestEnabled()) { 
int fibonacciValue = fibonacciprovider 


.getNthNumber (number); 
return new FibonacciNumber (number, fibonacciValue); 
} else throw new UnsupportedOperationException(); 





@ExceptionHandler (UnsupportedOperationException.class) 
public void unsupportedException (HttpServletResponse response) 
throws IOException { 
response.sendError\( 
HttpStatus.SERVICE_ UNAVAILABLE.value(), 
"This feature is currently unavailable" 
); 


@ExceptionHandler (Exception.class) 
public void handleGenericExceptionl( 
HttpServletResponse response, 
Exception e) throws IOException { 
String msg = "There was an error processing " + 
"your request: " + e.getMessage(); 
response.sendError( 
HttpStatus.BAD_ REQUEST.value(), 
msg 
); 


} 
注意 ,方法 fijbonacci 负 责 核实 应 当 启 用 还 是 禁用 fibonacci 服 务 。 如 果 该 禁用 ， 就 引发 
UnsupportedoperationException 异 常 , 还 有 两 个 错误 处 理 函 数 :第 一 个 处 理 异常 Unsuppor- 
tedOoperationException， 第 二 个 处 理 通用 异常 。 
所 有 组 件 都 就 绪 后 ， 只 需 执 行 Gradle 命 令 run: 


$> gradle run 


命令 将 启动 在 地 址 http://localhost:8080 处 搭建 服务 器 的 过 程 ， 如 下 面 的 控制 台 输出 所 示 : 



































2015-06-19 03:44:54.157 INFO 3886 --- [ main] o.s.w.s.handler. 
SimpleUrlHandlerMapping : Mapped URL path [/webjars/**] onto 

handler of type [class org.springframework.web.servlet.resource. 
ResourceHttpRequestHandler] 
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2015-06-19 03:44:54.160 INFO 3886 --- [ main] 
O.S.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/**] 

onto handler of type [class org.springframework .web.servlet.resource. 
ResourceHttpRequestHandler] 

2015-06-19 03:44:54.319 INFO 3886 --- [ main] o.s.w.s.handler. 
SimpleUrlHandlerMapping : Mapped URL path [/**/favicon.ico] onto 
handler of type [class org.springframework.web.servlet.resource. 
ResourceHttpRequestHandler] 


2015-06-19 03:44:54.495 INFO 3886 --- [ main] o.s.j.e.a.Annota 
tionMBeanExporter : Registering beans for JMX exposure on startup 
2015-06-19 03:44:54.649 INFO 3886 --- [ main] s.b.c.e.t.Tomcat 
EmbeddedServletContainer : Tomcat started on port(s): 8080 (http) 
2015-06-19 03:44:54.654 INFO 3886 --- [ main] c.p.tddjava. 
ch09 .Application : Started Application in 6.916 seconds (JVM 


running for 8.558) 
> Building 75% > :run 


启动 应 用 程序 后 ,使 用 浏览 器 执行 查询 。 查 询 的 URL 为 http://localhost:8080/fibonacci? 
number=7。 


这 个 查询 的 输出 如 下 所 示 。 








© /glocalhost:8080/fibonacci? x 





< @ | localhost:8080/fibonacci?number=7 Ye 


Whitelabel Error Page 


This application has no explicit mapping for /error, so you are seeing this as a fallback. 





Sun Jun 28 22:12:18 CEST 2015 
There was an unexpected error (type=Service Unavailable, status=503). 
This feature is currently unavailable 











从 中 可 知 ， 收 到 的 错误 对 应 于 REST API 在 功能 被 禁用 时 发 送 的 错误 。 如 果 功 能 被 启用 ， 返 
回 的 结果 将 为 -1。 








9.3.1 实现 fibonacci 服务 
大 多 数 读者 可 能 都 熟悉 斐 波 那 契 数列 , 但 有 些 读者 可 能 不 知道 它 为 何 物 , 下面 进行 简要 介 








斐 波 那 契 数 列 是 一 个 整数 数列 ， 通 过 反复 使 用 公式 Km=Na-lD)+H2 2) 计算 
得 。 这 个 数列 开头 的 两 个 数 为 K0) = 0 和 ft1) = 1， 而 其 他 所 有 数字 都 是 这 样 计 
算得 到 的 : 递归 使 用 前 面 的 公式 ， 知 道 公 式 中 的 每 项 都 为 已 知 值 0 或 1。 
换言之 ， 斐 波 那 契 数列 为 0, 1, 1, 2, 3, 5, 8, 13, 21, 34, SS, 89, 144... 
有 关 斐 波 那 契 数列 的 更 详细 信息 ， 请 参阅 http:/www.wolframalpha.cony/ 


input/?i=fibonaccitsequence。 
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我 们 还 想 限 制 计 算 斐 波 那 契 数 所 需 的 时 间 , 为 此 对 输入 进行 限制 : fibonacci 服 务 只 计算 斐 
波 那 契 数列 中 第 0~30 个 数字 。 


对 于 计算 斐 波 那 契 数 的 类 ， 一 种 可 能 的 实现 如 下 所 示 : 





@Service("fibonacci") 
public class FibonacciService { 
public static final int LIMIT = 30; 


public int getNthNumber (int n) { 
if (isOutOofLimits(n) { 
throw new IllegalArgumentException!( 
"Requested number must be a positive " + 
number no bigger than " + LIMIT) ; 


if (n == 0) return 0; 

了 二 三 th he 9 
iiit first; Second = 1 "esult, S 1 
do { 


first = second; 
second = result; 
result = first + secongd; 
-_n; 
} while (n > 2); 
return result; 


private boolean isOutOfLimits(int number) { 
return number > LIMIT || number < 0; 


} 
为 简洁 起 见 , 这 里 的 演示 未 包含 “ 红 灯 - 绿 灯 - 重 构 ” 这 个 TDD 过 程 
这 里 只 列 出 最 终 的 实现 和 测试 : 


宇 
[s 
油 
外 
湛 
全 
忆 
水 
各 
型 


public class FibonacciServiceTest { 
private FibonacciService tested; 
private final String expectedExceptionMessage = 
"Requested number " + 
"must be a positive number no bigger than " + 
FibonacciService.LIMIT; 


@Rule 
public ExpectedException exception = ExpectedException.none(); 


@Before 
public void peforeTest () { 
tested = new FibonacciService(); 


@Test 
public voidq test0() { 
int actual = tested.getNthNumber (0) ; 
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assertEquals (0, actual); 


@Test 

public void test1() { 
int actual = tested.getNthNumber (1); 
assertEquals(1, actual); 


@Test 

public void test7() { 
int actual = tested.getNthNumber (7); 
assertEquals (13, actual); 


@Test 
public void testNegative() { 
exception.expect (IllegalArgumentException.class); 
exception.expectMessage (is (expectedExceptionMessage)); 
tested.getNthNumber(-1); 


@Test 
public void testOutOfBounce() { 

exception.expect (IllegalArgumentException.class); 
exception.expectMessage (is (expectedExceptionMessage)); 
tested.getNthNumber (31) ; 





} 


现在 可 以 在 文件 application.yml 中 启用 斐 波 那 契 数 列 计算 功能 ， 并 使 用 浏览 器 执行 一 些 
查询 以 查看 结 





features : 
fibonacci: 
restEnabled: true 


执行 Gradle 命 令 run: 
$>gradle run 


现在 可 以 使 用 浏览 器 对 REST API 进 行 全 面 测 试 一 一 要 求 计 算 第 N 个 斐 波 那 契 数 (0 短 Vs30 )。 








ee localhost:8080/fibonacci?” x 








€ SC (localhost:8080/fibonacci?number=7 








{"number":7,"value":13} 

















NN 大 于 30 时 ,返回 的 结果 不 再 是 数字 ， 而 是 错误 消息 。 
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©@ Slocahoste080/ibonacc? x 








© |D localhost:8080/fibonaccianumber-abc 
Whitelabel Error Page 


This application has no explicit mapping for /error, so you are seeing this as a fallback. 





Fri Jun 19 04:08:01 CEST 2015 
There was an unexpected error (type=Bad Request, status=400). 
There was an error processing your request: Failed to convert value of type 'java.lang.String' to required type 'int'; nested exception is java.lang .NumberFormatException: For input string: "abe" 











9.3.2 ”使 用 模版 引擎 

我 们 现在 能 够 开关 斐 波 那 契 数 计算 功能 , 但 很 多 其 他 情形 下 ,功能 开关 也 很 有 用 。 比 如 对 于 
链接 到 未 完成 功能 的 Web 链 接 ， 可 将 其 隐藏 。 这 是 一 种 很 有 趣 的 用 法 ， 因 为 我 们 可 使 用 该 链接 的 
URL 测 试 发 布 到 生产 环境 的 功能 ， 同 时 对 其 他 用 户 隐 藏 这 个 链接 一 一 想 隐藏 多 久 就 隐藏 多 和 久 。 




















为 演示 这 一 点 ， 我 们 将 使 用 前 面 说 到 的 框架 Thymeleaf 创 建 一 个 简单 的 网 页 。 
首先 ， 添 加 一 个 新 的 控制 标志 : 


features : 
fibonacci: 
restEnabled: true 
webEnabled: true 


接 下 来 ， 在 一 个 配置 类 中 映射 这 个 新 标志 : 








private boolean webEnabled; 
public boolean isWebEnabled() { 
return webEnabled; 


} 


public void setWebEnabled (boolean webEnabled) { 
this.webEnabled = webEnabled; 
} 


我 们 将 创建 两 个 模版 。 一 个 是 主页 , 包含 几 个 用 于 计算 不 同辈 波 那 契 数 的 链接 。 这 些 链 接应 
仅 在 斐 波 那 契 数 计算 功能 被 启用 时 才 可 见 ， 因 此 有 一 个 模拟 这 种 行为 的 可 选 块 : 





<!DOCTYPE html> 
<html] xmlns:th="http://www.thymeleaf.org"> 
<head lang="en"> 
<meta http-equiv="Content-Type" 
content="text/html; charset=UTF-8" /> 
<title>HOME - Fibonacci</title> 
</head> 
<body> 
<div th:if="${isWebEnabled}"> 
<p>List of links:</p> 
<ul th:each="number : S$S{arrayOfIints}"> 
<l1i><a 
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th:href="@{/web/fibonacci (number=$ {number})}" 
th:text="'Compute ' + ${number} + 'th fibonacci'"> 
过 人 有 有 过 办 本 二 这 
</ul> 
</div> 
</body> 
</html> 


第 二 个 模版 显示 计算 得 到 的 斐 波 那 契 数 ， 还 包含 一 个 返回 到 主页 的 链接 : 


<!DOCTYPE html> 
<html xmlns:th="http://www.thymeleaf .org"> 
<head lang="en"> 
<meta http-equiv="Content-Type" 
content="text/html; charset=UTF-8" /> 
<title>Fibonacci Example</title> 
</head> 
<body> 
<p th:text="${number} + 'th number: ' + S${value}"></p> 
<a th:href="@{/}">back</a> 
</body> 
</html> 


这 两 个 模版 要 发 挥 作用 ， 必 须 位 于 特定 位 置 ， 分 别 为 src/main/resources/templates/ 


home.html 和 src/main/resources/templates/fibonacci.htm]l。 
最 后 是 核心 部 分 一 一 将 前 面 所 说 的 一 切 关联 起 来 并 使 其 正常 工作 的 控制 器 : 


@Controller 
public class FibonacciWebController { 
@Autowired 
FibonacciFeatureConfig fibonacciFeatureConfig; 














@Autowired 
@QOualifier ("fibonacci") 
private FibonacciService fibonacciprovider; 


@RequestMapping(value = "/", method = GET) 
public String home(Model model) { 
model.addAttributel( 
"ijsWebEnabled", 
fibonacciFeatureConfig.isWebEnabled() 


if (fibonacciFeatureConfig.isWebEnabled()) { 
model.addAttributel( 
"arrayOfIints", 
Arrays.asList(5, 7, 8, 16) 





} 
} 


return "home"; 


@RequestMapping (value ="/web/fibonacci", method = GET) 
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public String fibonaccI( 


@RequestParam(value = "number") Integer number, 
Model model) { 
if (number != null) { 


model.addAttribute("number", number); 
model.addAttributel 


"value", 
fibonacciprovider.getNthNumber (number)); 


} 


return "fibonacci"; 
} 
注意 ， 这 个 控制 器 与 前 面 的 REST API 示 例 中 的 控制 器 有 点 像 ， 因 为 它们 是 使 用 同一 个 框架 
创建 的 , 使 用 的 资源 也 相同 。 然而， 二 者 也 存在 一 些 细微 差别 ， 其 中 之 一 就 是 这 里 使 用 的 注解 为 
@Controller， 而 不 是 &RestController。 因为 Web 控 制 器 负责 向 模版 页 面 提 供 自 定义 信息 ; 
而 REST API 负 责 生成 用 JSON 对 象 表 示 的 响应 。 























下 面 再 次 使 用 Gradle 命 令 查 看 结果 : 
$> gradle clean run 


这 个 命令 生成 主页 。 





© (SHOoME.-Fibonacc x 








所 CC | localhost:8080 





List of links: 


e。 Click here to compute 5th fibonacci number 





e。 Click here to compute 7th fibonacci number 





e。 Click here to compute 8th fibonacci number 





e。 Click here to compute 16th fibonacci number 

















下 面 是 单 击 第 二 个 链接 的 结果 。 








@e@ee@ SS Fibonacci Example x 





€ SC (localhost:8080/web/fibonacci?number=7 





Fibonacci 7th number is 13 


back 
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我 们 使 用 如 下 代码 关闭 这 项 功能 : 


features: 
fibonacci: 
restEnabled: true 
webEnabled: false 


再 重新 启用 这 个 应 用 程序 并 浏览 器 主页 ， 此 时 看 不 到 链接 , 但 依然 能 够 计算 斐 波 那 契 数 , 条 
件 是 知道 相应 的 URL。 如 果 手 动 输入 URL http://localhost:8080/web/fibonacci?number=15， 依 然 能 
够 访问 包含 响应 的 相应 页 面 。 




















© ®@ SS Fibonacci Example x 











€ CC 口 localhost:8080/web/fibonacci?number=15 





Fibonacci 15th number is 610 


back 























这 种 做 法 很 有 用 , 但 通常 会 无 谓 地 增加 代码 复杂 度 。 请 别 忘 了 重 构 代码 ,删除 不 再 使 用 的 旧 
开关 ， 让 代码 更 整洁 、 可 读 性 更 高 。 另 外 ,一 个 不 错 的 主意 是 ， 让 修改 无 需 重启 应 用 程序 就 能 
效 ; 很 多 存储 方式 都 不 要 求 重启 应 用 程序 ， 其 中 最 流行 的 是 数据 库 。 















































9.4 小 结 


功能 开关 为 在 生产 环境 中 隐藏 和 处 理 未 完成 的 功能 提供 了 不 错 的 途径 。 根 据 需要 将 代码 部 署 
到 生产 环境 时 ,使 用 功能 开关 好 像 有 点 怪 ; 但 需要 持续 集成 、 持 续 交 付 或 持续 部 署 时 ， 经 常 使 用 
功能 开关 。 

我 们 简要 介绍 了 功能 开关 ， 并 讨论 了 其 优 缺 点 ， 还 列举 了 功能 开关 很 有 用 的 一 些 典 型 情形 。 

很 多 库 都 可 帮助 我 们 实现 功能 开关 ， 它 们 提供 了 大 量 功能 ， 如 使 用 Web 界 面 处 理 功能 、 将 首 
选项 存储 到 数据 库 以 及 让 你 能 够 访问 用 户 配置 文件 。 


最 后 , 我 们 实现 了 两 种 不 同 的 方法 : 针对 简单 REST API 的 功能 开关 ; 在 Web 应 用 程序 中 使 用 
功能 开关 。 
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“如 果 你 总 是 重复 过 去 做 过 的 事情 ， 结 果 也 会 一 成 不 变 。” 
阿尔 伯 特 ， 爱 因 斯 坦 

我 们 介绍 了 大 量 理论 , 还 进行 了 大 量 实践 。 整 个 旅程 就 像 一 辆 高 速 列车 , 我 们 根本 没有 机 会 
重 温 学 到 的 知识 ， 也 找 不 到 休息 的 时 间 。 


好 消息 是 现在 终于 找到 了 复习 的 空 除 ， 我 们 将 总 结 学 到 的 所 有 知识 ， 并 介绍 TDD 最 佳 实践 。 
其 中 有 些 最 佳 实践 在 前 面 提 到 过 ， 但 还 有 一 些 是 新 的 。 





10.1 TDD 概要 


“ 红 灯 - 绿 灯 - 重 构 ” 是 TDD 的 支柱 ， 将 TDD 过 程 分 解 为 可 重复 的 短暂 周期 ， 其 中 每 个 阶段 的 
持续 时 间 通 常 以 分 钟 乃 至 以 秒 计 。 我 们 编写 一 个 测试 ,确定 它 不 能 通过 后 , 编写 刚好 能 让 它 通过 
的 实现 代码 ,然后 运行 所 有 测试 ， 并 进入 绿灯 阶段 。 编 写 代码 后 不 断 对 其 重 构 ， 直 到 其 质量 到 达 
我 们 期 望 的 程度 。 在 这 个 阶段 ,测试 应 始终 能 够 通过 。 在 重 构 阶段 ， 既 不 能 引入 新 功能 ， 也 不 能 
编写 新 测试 。 如 此 短 的 时 间 内 完成 所 有 这 些 任务 好 像 不 太 可 能 ,也 可 能 让 人 感到 担心 。 但 愿 通过 
前 面 的 练习 ， 你 的 技能 、 信 心 和 速度 都 有 所 提高 。 


虽然 TDD 包 含 “ 测 试 ”一 词 ， 但 这 并 不 是 TDD 带 来 的 主要 好 处 ， 也 不 是 其 目标 所 在 。TDD 首 
先是 一 种 更 佳 的 代码 设计 方式 ,而 测试 只 是 副产品 ,用 来 不 断 核实 应 用 程序 确实 像 期 望 的 那样 工作 。 


前 面 反复 提 到 了 速度 的 重要 性 。 要 确保 速度 ， 你 需要 更 加 熟悉 TDD， 同 时 别 忘 了 使 用 测试 奉 
身 (模拟 对 象 、 存 根 、 间 谍 等 )。 使 用 测试 替身 可 避免 使 用 外 部 依赖 ， 如 数据 库 、 文 件 系 统 、 第 
三 方 服 务 等 。 


TDD 还 有 哪些 好 处 呢 ? 文档 是 其 中 之 一 。 鉴 于 只 有 代码 能 够 准确 而 实时 地 呈现 当前 开发 的 应 
用 程序 ， 因此 , 你 想 更 深入 地 了 解 某 段 代码 的 作用 时 ,首先 应 求助 于 使 用 TDD 编 写 的 规范 (也 是 





























































































































图 灵 社 区 会 员 yasenluobinh(yasenluobinhappy@163.com) 专 享 尊重 版 权 





10.2 ”最 佳 实 践 189 





设计 呢 ? 使 用 TDD 编 写 的 代码 设计 得 更 好 。 使 用 TDD 时 , 不 用 预先 定义 设计 ,相反 , 不 断 编 
写 并 实现 规范 的 过 程 中 , 设计 通常 会 变 得 清晰 。 与 此 同时 ,易于 测试 的 代码 都 是 设计 良好 的 ， 
为 测试 要 求 我 们 必须 应 用 一 些 最 佳 编码 实践 。 


我 们 还 了 解 到 ，TDD 并 非 只 适用 于 小 型 单元 (方法 )， 它 也 可 用 于 更 高 层面 。 这 些 层 面 专注 
于 功能 或 行为 ， 可 能 横 跨 多 个 方法 、 类 乃至 应 用 程序 和 系统 。 在 这 些 层面 ,使 用 的 TDD 是 行为 驱 
动 开 发 (BDD )。 不 像 TDD 那 样 基于 由 开发 人 员 为 开发 人 员 编 写 的 单元 测试 ，BDD 可 供 组 织 的 任 
D 涉 及 的 是 行为 ,而且 是 使 用 自然 ( 普通 ) 语言 编写 的 。 因 此 测试 人 员 、 业 务 代表 
等 都 能 参与 其 创建 ， 还 可 将 其 作为 参考 。 


我 们 将 遗留 代码 定义 为 不 带 测试 的 代码 。 我 们 遇 到 过 遗留 代码 带 来 的 一 些 挑 成 ,并 学 习 了 一 
些 让 遗留 代码 可 测试 的 技巧 。 


简要 总 结 TDD 后 ， 下 面 归纳 TDD 最 佳 实践 。 


何人 使 用 。BD 



















































































10.2 ”最 佳 实践 
编码 最 佳 实践 是 软件 开发 领域 长 期 以 来 总 结 的 





























套 非 正式 规则 , 可 帮助 改善 软件 质量 。 无 论 


编写 什么 应 用 程序 ， 都 需要 有 一 定 创意 ( 毕竟， 我 们 希望 打造 新 颖 或 更 好 的 东西 )， 而 编码 实践 


























可 帮助 我 们 避免 前 人 遇 到 过 的 一 些 问题 。 如 果 你 刚 接触 TDD, 最 好 遵循 别人 总 结 的 部 分 乃至 全 部 


最 佳 实践 。 


我 们 将 测试 驱动 开发 最 佳 实践 分 为 四 类 : 


口 命名 约 
口 流程 ; 


口 工具 。 





定 ; 


口 开发 实践 ; 


你 将 看 到 , 这 些 最 佳 实践 并 非 只 适用 于 TDD。 测试 驱动 开发 中 , 很 大 一 部 分 工作 是 编写 测试 ， 





























因此 接 下 来 将 介绍 的 很 多 最 佳 实践 也 适用 于 测试 ,还 有 一 些 也 适用 于 一 般 性 编码 ,不 管 源 自 何 处 ， 
你 践 行 TDD 时 ， 这 些 最 佳 实践 都 很 有 帮助 。 





定 哪 些 实践 、 相 









































E 架 和 风格 最 适合 其 项 目 和 团队 。 敏 损 


时 度 势 ， 为 团队 和 项 目 选 择 最 合适 的 工具 和 实践 。 





10.2.1 命名 约定 
命名 约定 有 助 于 更 好 地 组 织 测试 ， 从 而 让 开发 人 员 更 容易 测试 。 另 一 个 好 处 是 ,很 多 工具 都 


不 是 全 盘 接 受 他 人 制定 的 规则 ， 而 是 知道 审 
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要 求 遵循 这 些 约定 。 大 家 使 用 的 命名 约定 很 多 ， 这 里 介绍 的 只 是 沧海 一 票 。 无 论 什 么 命名 约定 ， 
都 聊 胜 于 无 。 最 重要 的 是 , 团队 的 每 个 成 员 都 知道 要 遵循 哪些 命名 约定 ， 并 能 熟练 使 用 。 选 择 流 
行 的 命名 约定 的 优点 在 于 ， 新 加 入 团队 的 成 员 能 快速 掌握 ， 因 为 既 有 的 知识 可 提供 帮助 。 
































好 处 : 可 避免 不 小 心 将 测试 和 产品 二 进 制 文件 一 起 打包 ; 很 多 构建 工具 都 要 


RR 将 实现 代码 和 测试 代码 分 开 
9 求 测试 位 于 特定 源 代 码 目录 。 





常见 的 做 法 是 至 少 创建 两 个 源 代码 目录 ， 将 实现 代码 放 在 目录 src/main/java 中 ， 并 将 测 
试 代码 放 在 目录 src/test/java 中 。 在 较 大 的 项 目 ， 源 代码 目录 可 能 更 多 ,但 也 必须 将 实现 代 
码 和 测试 代码 分 开 。 

Gradle 和 Maven 等 构建 工具 不 仅 要 求 将 测试 代码 和 实现 代码 放 在 不 同 的 源 代码 目录 ， 还 要 遵 
循 特定 的 命名 约定 。 

你 可 能 注意 到 ,本 书 始终 使 用 的 文件 buila.gradale 没 有 明确 指定 要 测试 什么 ,也 没有 指定 
要 使 用 哪些 类 创建 .jar 文 件 。Gradle 假 定 测试 位 于 目录 src/test/java， 而 要 打包 到 jar 文 件 的 
实现 代码 位 于 目录 src/main/java。 














a 将 测试 类 和 实现 放 在 一 个 包 中 
好 处 ;知道 测试 和 代码 位 于 同一 个 包 中 有 助 于 更 快 找 到 代码 。 





正如 前 一 个 实践 指出 的 ， 测 试 和 代码 虽然 位 于 同一 个 包 ， 但 位 于 不 同 的 源 代码 目录 。 
本 书 所 有 练习 都 遵循 了 这 个 约定 。 








» 以 类 似 于 受 测 类 的 方式 给 测试 类 命名 
QQ 好 处 : 知道 测试 和 受 测 类 的 名 称 类 似 后 ， 有 助 于 快速 找到 受 测 类 。 








一 种 常见 的 做 法 是 ， 也 这 样 给 测试 命名 ， 即 为 实现 类 加 上 后 级 Test。 例 如 ， 如 果实 现 类 为 
TickTackToe， 就 将 测试 类 命名 为 TickTackToeTest。 


然而 ， 除 贯穿 重 构 练 习 都 使 用 的 测试 类 外 ， 我 们 都 使 用 后 缀 spec。 这 有 助 于 明确 指出 ， 创 
建 测 试 方法 的 主要 目的 是 指定 要 开发 的 内 容 。 测 试 是 规范 的 绝妙 副产品 。 


a 给 测试 方法 指定 描述 性 名 称 
好 处 : 有 助 于 明白 测试 的 目标 。 
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使 用 对 测试 进行 描述 的 方法 名 时 ,有 助 于 掌握 测试 失败 的 原因 , 以 及 在 什么 情况 下 通过 添加 
测试 可 提高 代码 覆盖 率 。 必 须 明确 指出 测试 前 设置 了 哪些 条 件 、 测 试 将 执行 哪些 操作 以 及 期 望 的 


结 








给 测试 方法 命名 的 方式 有 很 多 ， 我 们 选择 的 方式 是 采用 BDD 场 景 中 使 用 的 Given/when/ 
Then 语 法 : Given 部 分 描述 前 置 条 件 ，when 部 分 描述 操作 ， 而 Then 部 分 描述 期 望 的 结果 。 如 果 
测试 没有 前 置 条 件 ( 这 通常 是 在 用 @Before 和 @Beforeclass 注 解 的 方法 中 设置 的 )， 可 省 略 
Given 部 分 。 


下 面 看 一 个 为 “ 井 字 游戏 ”创建 的 规范 : 


@Test 
public void whenpPplayAndWholeHorizontalLineThenWinner() { 
ticTacToe.play (1, 1); // Xx 
ticTacToe.play (1, 2); // 0 
ticTacToe.play (2, 1); // X 
(2 























ticTacToe.play (2, 2); // 0 
String actual ticTacToe.play (3, 1); // X 
assertEquals ("XxX is the winner", actual); 


} 
只 要 阅读 这 个 方法 的 名 称 ， 就 能 知道 它 是 做 什么 的 : 玩家 落 子 后 ， 如果 其 棋子 填 满 了 整 条 水 
平 线 ， 该 玩家 就 说 了 。 


» 不 要 完全 依赖 注释 以 提供 有 关 测 试 目标 的 信息 。 因 为 从 IDE 执 行 测试 时 ， 注 
a 释 不 会 出 现 ， 它 们 也 不 会 出 现在 CI 或 构建 工具 生成 的 报告 中 。 


10.2.2 流程 
TDD 流 程 是 一 套 最 重要 的 实践 。 要 成 功 实施 TDD， 有 赖 于 本 节 介 绍 的 实践 。 


总 先 编写 测试 ， 再 编写 实现 代码 
好 处 : 这 可 确保 编写 的 代码 是 可 测试 的 ， 即 每 个 代码 都 有 为 之 编写 的 测试 。 




















通过 先 编写 或 修改 测试 , 开发 人 员 将 在 着 手 编写 实现 代码 前 专注 于 需求 , 这 是 TDD 与 完成 
实现 后 再 编写 测试 的 主要 差别 所 在 。 先 编写 测试 的 为 一 个 好 处 时 ,可 避免 测试 变 成 质量 检查 ( 而 
不 是 质量 保证 ) 的 手段 。 我 们 要 力图 确保 质量 是 内 生 的 ， 而 不 是 事后 再 去 检查 是 否 达到 了 质量 
标准 。 







































































> 仅 在 测试 失败 后 才 编 写 新 代码 
QQ 好 处 : 这 确认 了 在 没有 实现 的 情况 下 ， 测 试 不 管用 。 
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如 果 测 试 不 要 求 编写 或 修改 实现 就 能 通过 , 则 说 明 要 么 它 测 试 的 功能 已 经 实现 , 要 么 测试 本 
身 存在 缺陷 。 如 果 测 试 定义 的 新 功能 没有 实现 而 总 是 能 够 通过 ， 就 说 明 它 毫 无 用 处 。 测 试 必须 因 
预期 的 原因 而 失败 ， 此 时 ， 虽 然 不 能 保证 它 验证 了 正确 的 事情 ， 但 能 够 确定 验证 本 身 是 正确 的 。 












































总 每 次 修改 实现 代码 后 ， 都 再 次 运行 所 有 测试 
好 处 : 确保 代码 更 改 没有 带 来 任何 意料 之 外 的 副作用 。 





每 次 修改 实现 代码 后 ， 都 应 运行 所 有 测试 。 理 想 情 况 下 ,测试 的 执行 速度 很 快 ， 且 开发 人 员 
可 在 本 地 执行 。 将 代码 提交 给 版 本 控制 系统 后 ,应 再 次 运行 所 有 测试 ， 以 确保 代码 合并 没有 带 来 
任何 问题 ; 这 在 多 位 开发 人 员 协 作 开 发 代码 时 尤其 重要 。 应 使 用 诸如 Jenkins ( http://jenkins- 
ci.org/ )、Hudson ( http://hudson-ci.org/ )、Travis ( https:// travis-ci.org/ ) 和 Bamboo ( https://www. 
atlassian.com/software/bamboo ) 等 持续 集成 工具 从 仓库 提取 代码 ， 对 其 进行 编译 并 运行 测试 。 























> 仅 当 所 有 测试 都 通过 后 才 编 写 新 测试 
Q 好 处 : 将 始终 专注 于 小 型 工作 单元 ; 实现 代码 几乎 始终 处 于 可 运行 的 状态 。 





有 时 候 开 发 人 员 很 想 编写 多 个 测试 再 编写 实现 ; 还 有 些 时 候 , 开发 人 员 对 现 有 测试 发 现 的 问 
题 置 若 回 闻 ， 转 而 开发 新 功能 。 这 些 做 法 应 尽 可 能 避免 。 大 多 数 情 况 下 ,违反 前 述 规则 都 将 增加 
技术 债务 , 需要 连 本 带 息 一 起 偿还 。“ 实 现代 码 几 乎 始终 像 期 望 的 那样 工作 ”是 TDD 的 目标 之 一 。 
有 些 项 目 由 于 交付 日 期 迫在眉睫 ,或 为 避免 超过 预算 而 违反 这 条 规则 , 将 时 间 全 部 用 于 实现 新 功 
巴 与 失败 测试 相关 联 的 代码 修复 工作 推 后 。 这 些 项 目 通常 不 可 避免 地 要 推迟 交付 。 

































































or 














能 
>» 仅 当 测试 都 通过 后 才 重 构 
ea 好 处 : 这 样 的 重 构 是 安全 的 。 
如 果 所 有 可 能 受 重 构 影 响 的 实现 代码 都 有 配套 测试 , 且 测 试 都 通过 , 那么 重 构 将 是 相对 安全 
的 。 大 多 数 情况 下 , 重 构 期 间 都 不 需要 编写 新 测试 “对 既 有 测试 做 细微 修改 即 可 。 对 重 构 来 说 ， 
期 望 的 结果 是 在 修改 代码 之 前 和 之 后 ， 所 有 测试 都 能 通过 。 
































10.2.3 ”开发 实践 
本 节 介 绍 的 实践 致力 于 以 最 佳 方式 编写 测试 。 

















-> 编写 让 测试 能 够 通过 的 最 简单 的 代码 
QQ 好 处 ， 确保 设计 越 来 越 清晰 ; 避免 实现 不 必要 的 功能 。 
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这 里 的 理念 是 ， 实 现 越 简单 ， 产 品 越 好 ， 日 越 容易 维护 。 这 个 理念 遵循 了 KISS 原 则 。 
Re 
必须 避免 不 必要 的 复杂 性 。 


» 先 编写 断言 ， 再 编写 操作 
Q 好 处 : 这 将 更 早 洪 清 测试 目的 。 


编写 断言 后 , 测试 目的 就 清晰 了 , 这 让 开发 人 员 可 专注 于 满足 该 断言 的 代码 , 再 专注 于 实际 
实现 。 
































总 最 大 限度 减少 每 个 测试 中 的 断言 
好 处 : 避免 不 知道 哪个 断言 导致 测试 失败 ; 让 更 多 断言 得 以 执行 。 











如 果 一 个 测试 方法 中 使 用 多 个 断言 ,可 能 难以 判断 哪个 断言 导致 了 测试 失败 。 Tn 
程 中 执行 测试 时 ,这 种 问题 尤为 常见 。 如 果 问 题 不 能 在 开发 人 员 的 计算 机 中 重 现 (例如 ,问题 是 
环境 因素 导致 的 )， 可 能 难以 修复 ， 进 而 耗费 大 量 时 间 。 


断言 失败 时 ， 其 所 属 测试 方法 将 停止 执行 。 如 果 这 个 方法 中 还 有 其 他 断言 ， 这 些 断 言 将 不 会 
执行 ， 导 致 无 法 获得 原本 可 用 于 调试 的 信息 。 


最 后 ， 包 含 多 个 断言 会 令 人 迷惑 ， 不 知道 测试 的 目标 到 底 是 什么 。 


这 种 实践 并 不 意味 着 每 个 测试 方法 都 只 能 包含 一 个 断言 。 如 果 有 多 个 测试 相同 逻辑 条 件 或 功 
能 单元 的 断言 ， 可 将 它们 都 放 在 同一 个 测试 方法 中 。 


下 面 看 几 个 示例 : 


@Test 



































public final void whenOneNumberIisUsedThenReturnValueIsThatSameNumber () 
{ 

Assert.assertEquals(3, StringCalculator.add("3")); 
} 


@Test 

public final void whenTwoNumbersAreUsedThenReturnValueIsTheirSum() { 
Assert.assertEquals (3+6, StringCalculator.add("3,6")); 

} 


上 述 代 码 包 含 两 个 测试 ,它们 明确 指出 了 自己 的 目标 。 通过 阅读 方法 名 和 查看 测试 ,可 以 清 
楚 地 知道 测试 的 是 什么 。 请 看 下 面 示例 : 


@Test 
public final void 
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whenNegativeNumbersAreUsedThenRuntimeExceptionIsThrown() { 
RuntimeException exception = null; 
Cry 
StringCalculator.add("3,-6,15,-18,46,33"); 
} catch (RuntimeException e) { 
exception = e; 
} 
Assert.assertNotNull ("Exception was not thrown", exception); 
Assert.assertEquals ("Negatives not allowed: [-6, -18]", 
exception.getMessage()); 





} 

这 个 测试 包含 多 个 断言 ， 但 它们 测试 的 是 同一 个 逻辑 功能 单元 。 第 一 个 断言 确认 存在 异常 ， 
第 二 个 断言 确认 异常 消息 是 正确 的 。 在 同一 个 测试 方法 中 使 用 多 个 断言 时 ,这些 断 言 都 应 包含 对 
失败 原因 进行 解释 的 消息 ,这 样 调试 失败 的 断言 将 更 容易 。 测 试 方法 只 有 一 个 断言 时 ， 消 息 是 受 
欢迎 的 ， 但 并 非 必 不 可 少 ， 因 为 从 方法 名 就 能 清楚 知道 测试 目标 。 

@Test 

public final void whenAddIsUsedThenItWorks() { 

Assert.assertEquals (0, StringCalculator.add("") 


)3 
Assert.assertEquals(3, StringCalculator.add("3")); 
Assert.assertEquals (3+6, StringCalculator.add("3,6")); 



































Assert.assertEquals (3+6+15+18+46+33, 

stringCaleulator ado("3 6;15; L846 337))? 
Assert.assertEquals(3+6+15, StringCalculator.add("3,6n15")); 
Assert.assertEquals (3+6+15, 


StringCalculator.add("//;n3;6;15")); 
Assert.assertEquals (3+1000+6, 
StringCalculator add("™3 L000 L001;6;12347))3 








} 


这 个 测试 包含 很 多 断言 ， 其 目标 不 明 ; 如 果 其 中 一 个 断言 失败 , 将 无 法 知道 其 他 断言 是 否 
用 。 使 用 CI 工具 执行 这 个 测试 时 ， 如 果 它 失败 ， 可 能 难以 搞 明 白 失 败 原因 。 


芭 











总 不 要 让 测试 依赖 其 他 测试 
电 好 处 : 测试 能 以 任何 顺序 独立 执行 ,不 管 运行 全 部 还 是 部 分 测试 ,都 将 如 此 。 


每 个 测试 都 应 独立 于 其 他 测试 。 开发 人 员 应 该 能 够 执行 任 一 、 部 分 或 全 部 测试 。 鉴 于 测试 运 
行 器 的 设计 , 测试 的 执行 顺序 通常 是 不 确定 的 。 如 果 测 试 之 间 存在 依赖 关系 ， 引 入 新 测试 时 ， 这 
种 依赖 关系 很 容易 遭 到 破坏 。 























测试 的 运行 速度 必须 很 快 


好 处 : 这 样 就 能 经 常 运行 测试 。 








如 果 测 试 的 运行 时 间 很 长 , 开发 人 员 将 不 再 运行 , 或 者 只 运行 与 所 做 修改 相关 的 很 少 一 部 分 
测试 。 除 促使 开发 人 员 使 用 它们 外 , 测试 运行 速度 快 的 另 一 个 好 处 是 可 快速 提供 反馈 。 问 题 发 现 
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得 越 时 ， 修 复 就 越 容 易 ， 因 为 此 时 对 导致 问题 的 代码 还 记忆 犹 新 。 如 果 等 待 测试 执行 完毕 期 间 ， 
开发 人 员 已 开始 着 手 处 理 下 一 个 功能 ， 他 可 能 决定 将 修复 问题 的 工作 推迟 到 完成 新 功能 后 去 做 。 
另 一 方面 ， 如 果 他 放下 手头 的 工作 去 修复 问题 ， 将 因 调 整 思路 而 浪费 时 间 。 


测试 的 运行 速度 必须 很 快 , 让 开发 人 员 每 次 修改 后 都 能 运行 所 有 测试 , 而 不 会 感到 厌烦 或 气 蚀 。 


3 使 用 测试 替身 
电 好 处 : 减少 代码 依赖 并 提高 测试 的 执行 速度 。 


要 快速 执行 测试 并 专注 于 单个 功能 单元 , 必须 使 用 模拟 对 象 ,通过 模拟 受 测 方法 的 外 部 依赖 ， 
开发 人 员 能 够 专注 于 手头 的 任务 , 而 无 需 花 时 间 建 立 这 些 依赖 。 在 小 组 较 大 或 多 个 小 组 协同 工作 
的 情况 下 ， 这 些 依赖 甚至 可 能 还 没有 开发 。 另 外 , 不 使 用 模拟 对 象 的 情况 下 ,测试 的 执行 速度 通 
常 很 慢 。 数 据 库 、 其 他 产品 、 服 务 等 都 非常 适合 使 用 模拟 对 象 进行 代替 。 
































3 Use set-up and tear-down methods 
Q 好 处 : 让 我 们 能 够 在 类 或 各 个 测试 方法 之 前 和 之 后 执行 设置 和 拆除 代码 。 





我 们 通常 需要 在 测试 类 或 其 每 个 方法 之 前 执行 一 些 代码 ， 为 此 ，JUnit 提 供 了 注解 
eBeforeclass 和 eBefore。 注 解 eBeforeclass 在 类 被 加 载 前 ( 第 一 个 测试 方法 运行 前 ) 执行 
与 之 关联 的 方法 , 而 eBefore 在 每 个 测试 运行 前 执行 与 之 关联 的 方法 。 这 两 个 注解 用 于 测试 存在 
前 置 条 件 的 情形 ， 最 常见 的 例子 是 在 数据 库 〈 很 可 能 位 于 内 存 ) 中 设置 测试 数据 。 

与 这 两 个 注解 对 应 的 是 aafter 和 eafterclass， 它 们 的 主要 用 途 是 销毁 设置 阶段 或 其 他 测 
试 创建 的 数据 或 状态 。 前 一 个 实践 说 过 ,每 个 测试 都 应 独立 于 其 他 测试 ; 另外 ,任何 测试 都 不 应 
受 其 他 测试 的 影响 。 拆 除 阶段 有 助 于 确保 系统 就 像 之 前 未 执行 任何 测试 一 样 。 


Re 不 要 在 测试 中 使 用 基 类 
好 处 : 让 测试 更 清晰 。 


开发 人 员 常 常 像 编写 实现 代码 那样 编写 测试 代码 。 一 种 常见 的 错误 是 创建 基 类 , 并 让 测试 对 
其 进行 扩展 。 这 种 做 法 可 避免 代码 重复 , 但 代价 是 测试 不 清晰 。 应 尽 可 能 在 测试 中 少 用 甚至 不 用 
基 类 。 如 果 为 理解 测试 背后 的 逻辑 而 必须 从 测试 类 导航 到 其 父 类 、 祖 父 类 等 ,通常 会 引发 无 谓 的 
迷惑 。 相 比 于 避免 代码 重复 ， 测 试 的 清晰 度 更 重要 。 















































10.2.4 工具 


TDD 中 , 编码 和 测试 都 严重 依赖 其 他 工具 和 流程 。 这 里 列 出 一 些 最 重要 的 , 其 中 每 个 都 是 庞 
大 的 主题 ,无 法 在 本 书 中 深入 探索 ， 只 做 简要 的 描述 。 
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San 率 和 持续 集成 (CI) 工具 
处 : 确保 测试 尾 盖 每 个 角落 。 





为 判断 是 否 测试 了 所 有 代码 、 分 支 以 及 复杂 度 , 代码 覆盖 率 实 践 和 工具 很 有 帮助 。 这 样 的 工 
具 包 括 JaCoCo ( http:/www.eclemma.org/jacoco/ )、Clover ( https:/www.atlassian.com/software/ 
clover/overview 和 Cobertura (http://cobertura.github.io/cobertura/ )。 


除非 项 目 非常 简单 ， 和 否则 持续 集成 (CI ) 必 不 可 少 。 最 常用 的 持续 集成 工具 包括 Jenkins 
( http://jenkins-ci.org/ )、Hudson ( http://hudson-ci.org/ )、Travis (https://travis-ci.org/ ) 和 Bamboo 


( https://www.atlassian.com/software/bamboo )。 











结合 使 用 TDD 和 BDD 
好 处 : 涵盖 面向 开发 人 员 的 单元 测试 和 面向 客户 的 功能 测试 。 


虽然 TDD 单 元 测试 很 好 , 但 很 多 情况 下 , 这 并 不 能 提供 项 目 需 要 的 所 有 测试 。 TDD 可 提高 开 
发 速度 ,帮助 完成 设计 , 并 通过 快速 反馈 赋予 开发 人 员 以 信心 ; 而 BDD 更 适合 用 于 集成 测试 和 功 
能 测试 ， 它 提供 了 更 佳 的 需求 收集 流程 (通过 叙述 收集 )， 还 是 一 种 更 佳 的 沟通 方式 ( 通过 场景 
与 客户 沟通 )。 你 应 同时 使 用 它们 ， 因 为 它们 一 起 提供 了 完整 的 流程 ， 让 所 有 相关 方 和 团队 成 员 
都 参与 其 中 。 你 应 结合 使 用 (基于 单元 测试 的 ) TDD 和 BDD 了 驱动 开发 过 程 。 我 们 推荐 使 用 TDD 
提高 代码 覆盖 率 以 及 提供 快速 反馈 , 使 用 BDD 自 动 化 验收 测试 。TDD 主 要 致力 于 白 盒 测 试 , BDD 
通常 致力 于 黑 盒 测 试 ， 但 它们 都 专注 于 质量 保证 而 不 是 质量 检查 。 

























































































10.3 这 只 是 开始 


你 可 能 指望 读 完 本 书后 就 能 知道 测试 驱动 开发 的 方方面面 , 如 果真 是 这 样 ， 很 抱歉 ， 让 你 失 
望 了 。 要 掌握 任何 手艺 都 需要 很 长 的 时 间 和 大 量 的 实践 ，TDD 也 不 例外 。 请 继续 努力 吧 , 将 学 到 
的 知识 用 于 项 目 ， 与 同事 分 享 这 些 知 识 ， 最 重要 的 是 实践 、 实 践 再 实践 。 就 像 空手 道 一 样 ， Ds 
全 面 掌握 测试 驱动 开发 ， 只 能 通过 持续 练习 ， 别 无 他 法 。 我 们 使 用 TDD 很 长 时 间 了 ,依然 常 
临 新 的 挑战 ， 也 和 常常 学 到 改进 手艺 的 新 方式 。 




























































































10.4 这 并 非 终点 


本 书 的 编写 是 个 漫长 的 旅程 ,期 间 充 满 了 艰难 险阻 ,但 我 们 很 享受 这 个 过 程 , 但 愿 你 也 觉得 
阅读 本 书 是 一 种 享受 。 


我 们 通过 博客 ( http://technologyconversations.com ) 分 享有 关 各 种 主题 的 经 验 。 
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使 用 各 种 技巧 设计 简单 而 易于 维护 的 代码 
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看 完了 


如 果 您 对 本 书 内 容 有 疑问 ， 可 发 邮件 至 contact@turingbook.com， 会 有 编辑 或 作 
译 者 协助 答疑 。 也 可 访问 图 灵 社 区 ， 参 与 本 书 讨论 。 


如 果 是 有 关 电 子 书 的 建议 或 问题 ， 请 联系 专用 客服 邮箱 : 


ebook@turingbook.com。 
在 这 可 以 找到 我 们 : 


微 博 @ 图 灵 教育 : 好 书 、 活 动 每 日 播报 

微 博 @ 图 灵 社 区 : 电子 书 和 好 文章 的 消息 

微 博 @ 图 灵 新 知 : 图 灵 教 育 的 科普 小 组 

微 信 图 灵 访 谈 : ituring_interview， 讲 述 码 农 精彩 人 生 
微 信 图 灵 教 育 : turingbooks 
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